Object Collection Validator

Class Name: ObjectCollectionValidator

Attribute Name: ObjectCollectionValidatorAttribute

Configuration tool name: Object Collection Validator

Description

This validator checks that the object is a collection of the specified type and then invokes validation on each element of the collection. If the object you want to validate is null, the validation is ignored. If the object you want to validate is not a collection, then the validation fails and the rule set is not applied. If there are elements in the collection that are of a different type than the one you specified for the object, then the validation for these elements fails but this does not affect validation for the other elements.

Properties

The following table lists the object collection validator properties. The actual property names shown in the configuration tools are listed in the table description.

Message Template Tokens

If the message template contains tokens (for example, "{0}"), the validator will replace these tokens with values when the ValidationResult is created. The tokens supported by the object collection validator are listed in the following table.

Example

The following example shows how to use the object collection validator with attributes to check that each part in a kit's part list meets the requirements of the Part type's validator. The Part type's validator checks that the name is fewer than 20 characters and that the manufacturer's URL is well formed according to a particular regular expression pattern.

public class Part
{
  [StringLengthValidator(20)]
  string name;
  [RegexValidator(@"http://(www\.)?([^\.]+)\.com")]
  string manufacturerUrl;
  // ...
}

public class Kit
{
  [ObjectCollectionValidator(typeof(Part))]
  public Part[] PartList
  {
    get
    {
      return partList;
    }
  }
  // ...
}

'Usage
Public Class Part
  <StringLengthValidator(20)> _
  Dim name As String
  <RegexValidator("http://(www\.)?([^\.]+)\.com")> _
  Dim manufacturerUrl As String
  ' ...
End Class

Public Class Kit
  <ObjectCollectionValidator(GetType(Part))> _
  ReadOnly Property PartList(ByVal _partList As String)
    Get
      Return _partList
    End Get
  End Property
  ' ...
End Class