IncludeListValidator Class

Represents a special CellValidator that validates whether the specified value exists in the given Candidates list.

Object Model

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#

<ToolboxBitmapAttribute()>
Public Class IncludeListValidator 
   Inherits CellValidator
   Implements INamedObject

Dim instance As IncludeListValidator

[ToolboxBitmap()]
public class IncludeListValidator : CellValidator, INamedObject

Remarks

You can set a pre-defined System.String array to the Candidates property. If the cell value exists in the array, the validation is successful.

Example

The following code example uses the IncludeListValidator to validate whether the input value is included in the "null,2,3,4,5" list. If you input 1 in the Cell, then move the current cell to another cell, an error glyph icon is displayed to show the validation failed. If you input 2 in the cell, then move the current cell to another cell, no error glyph icon is displayed, and the validation is successful. This example is part of a larger example available for the CellValidator class.

void setIncludeListValidator_Click(object sender, EventArgs e)
        {
            Template template = Template.CreateGridTemplate(1);

            IncludeListValidator includeListValidator = new IncludeListValidator();
            includeListValidator.Candidates = new string[] { null, "2", "3", "4", "5" };

            IconNotify iconNotify = new IconNotify();
            iconNotify.IconAlignment = ContentAlignment.MiddleCenter;
            iconNotify.IconTip = "The editing value is not within the specified candidate list!";
            //When CurrentCell move to another Cell, the action will be done.
            iconNotify.DoActionReason = ValidateReasons.CellValidating;

            includeListValidator.Actions.Add(iconNotify);

            template.Row.Cells[0].Validators.Add(includeListValidator);

            this.gcMultiRow1.Template = template;
            label.Text = "The IncludeListValidator.Candidates list is 'null,2,3,4,5', input 1 in edit mode, then move 
CurrentCell to another Cell to trigger validation (DoActionReason is CellValidating), an error icon pops up to notify you 
validation failed.";
        }

VB.NET

Private Sub setIncludeListValidator_Click(ByVal sender As Object, ByVal e As EventArgs) Handles 
setIncludeListValidator.Click
        Dim template As Template = template.CreateGridTemplate(1)

        Dim includeListValidator As New IncludeListValidator()
        includeListValidator.Candidates = New String() {Nothing, "2", "3", "4", "5"}

        Dim iconNotify As New IconNotify()
        iconNotify.IconAlignment = ContentAlignment.MiddleCenter
        iconNotify.IconTip = "The editing value is not within the specified candidate list!"
        'When CurrentCell move to another Cell, the action will be done.
        iconNotify.DoActionReason = ValidateReasons.CellValidating

        includeListValidator.Actions.Add(iconNotify)

        template.Row.Cells(0).Validators.Add(includeListValidator)

        Me.gcMultiRow1.Template = template
        label.Text = "The IncludeListValidator.Candidates list is 'null,2,3,4,5', input 1 in edit mode, then move CurrentCell 
to another Cell to trigger validation (DoActionReason is CellValidating), an error icon pops up to notify you validation 
failed."
    End Sub

Inheritance Hierarchy

System.Object
GrapeCity.Win.MultiRow.CellValidator
GrapeCity.Win.MultiRow.IncludeListValidator

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

IncludeListValidator Members
GrapeCity.Win.MultiRow Namespace
CellValidator Class
CellValidateAction Class
ValidateContext Class
ExcludeListValidator Class