InvalidCellStyle Property

Gets or sets a CellStyle that is used for the validating Cell when the validation fails.

Syntax

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

<SRDescriptionAttribute("Indicates a cell style which is displayed when the validation fails.")>
<RefreshPropertiesAttribute(RefreshProperties.All)>
Public Property InvalidCellStyle As CellStyle

Dim instance As CellStyleNotify
Dim value As CellStyle
 
instance.InvalidCellStyle = value
 
value = instance.InvalidCellStyle

[SRDescription("Indicates a cell style which is displayed when the validation fails.")]
[RefreshProperties(RefreshProperties.All)]
public CellStyle InvalidCellStyle {get; set;}

Property Value

A CellStyle value that is used for the validating Cell when validation fails.

Remarks

You should not set InvalidCellStyle properties that are not related to the cell's appearance.

Example

The following code example uses the PairCharValidator to validate whether the input string matches the char pair '( )'. When you enter edit mode and input 2*(3+4 , the right ')' does not match the left '('. The input text's font changes to a bold red color to notify you that 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

CellStyleNotify Class
CellStyleNotify Members