PairChars Property

Gets a PairChar list that is matched to the specified value.

Syntax

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

<SuppressMessageAttribute(Category="Microsoft.Design", 
   CheckId="CA1002:DoNotExposeGenericLists", 
   Scope="", 
   Target="", 
   MessageId="", 
   Justification="")>
<DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Content)>
<SRDescriptionAttribute("Indicates a set of pair characters that are matched by the specified value.")>
Public ReadOnly Property PairChars As List(Of PairChar)

Dim instance As PairCharValidator
Dim value As List(Of PairChar)
 
value = instance.PairChars

[SuppressMessage(Category="Microsoft.Design", 
   CheckId="CA1002:DoNotExposeGenericLists", 
   Scope="", 
   Target="", 
   MessageId="", 
   Justification="")]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
[SRDescription("Indicates a set of pair characters that are matched by the specified value.")]
public List<PairChar> PairChars {get;}

Property Value

A PairChar list that is matched to the specified value.

Example

The following code example uses the PairCharValidator to validate whether the input string matches the char pair '( )'. If you enter edit mode and input 2*(3+4, the right ')' does not match the left '(', and the input text font changes to a bold red color to notify you the validation failed. This example is part of a larger example available for the CellValidator class.

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

            PairCharValidator pairCharValidator = new PairCharValidator();
            pairCharValidator.PairChars.Add(new PairChar('(', ')'));

            CellStyleNotify cellStyleNotify = new CellStyleNotify();
            cellStyleNotify.InvalidCellStyle.ForeColor = Color.Red;
            cellStyleNotify.InvalidCellStyle.Font = new Font(DefaultFont, FontStyle.Bold);
            cellStyleNotify.DoActionReason = ValidateReasons.EditedFormattedValueChanged;

            pairCharValidator.Actions.Add(cellStyleNotify);

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

            this.gcMultiRow1.Template = template;
            label.Text = "The PairCharValidator.PairChars is '( )', in edit mode, if you input '2*(3+4' to trigger validation, 
validation fails, the font changes, if input '2*(3+4)' to trigger validation, the validation succeeds.";
        }

VB.NET

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

        Dim pairCharValidator As New PairCharValidator()
        pairCharValidator.PairChars.Add(New PairChar("("c, ")"c))

        Dim cellStyleNotify As New CellStyleNotify()
        cellStyleNotify.InvalidCellStyle.ForeColor = Color.Red
        cellStyleNotify.InvalidCellStyle.Font = New Font(DefaultFont, FontStyle.Bold)
        cellStyleNotify.DoActionReason = ValidateReasons.EditedFormattedValueChanged

        pairCharValidator.Actions.Add(cellStyleNotify)

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

        Me.gcMultiRow1.Template = template
        label.Text = "The PairCharValidator.PairChars is '( )', in edit mode, if you input '2*(3+4' to trigger validation, 
validation fails, the font is changed, if input '2*(3+4)' to trigger validation, the validation succeeds."
    End Sub

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

PairCharValidator Class
PairCharValidator Members