Represents a special CellValidator that validates whether the specifed value matches the given regular expression.
Object Model
Syntax
<ToolboxBitmapAttribute()> Public Class RegularExpressionValidator Inherits CellValidator Implements INamedObject
Dim instance As RegularExpressionValidator
[ToolboxBitmap()] public class RegularExpressionValidator : CellValidator, INamedObject
Remarks
This CellValidator validates whether the validated value's string representation matches a specified regular expression. This is an exact match.
Example
The following code example uses the RegularExpressionValidator to validate whether the input value matches Expression, which indicates a currency value. If you input '-!2.05' in the Cell, then move the current cell to another Row, the focus cannot leave, because the input value does not match the Expression. The FocusProcess occurs. If you input '-12.05', it matches. This example is part of a larger example available for the CellValidator class.
void setRegularExpressionValidator_Click(object sender, EventArgs e) { Template template = Template.CreateGridTemplate(1); RegularExpressionValidator regularExpressionValidator = new RegularExpressionValidator(); //Define a regular expression for currency values. regularExpressionValidator.Expression = @"^-?\d+(\.\d{2})?$"; regularExpressionValidator.RegexOptions = System.Text.RegularExpressions.RegexOptions.CultureInvariant; FocusProcess focusProcess = new FocusProcess(); focusProcess.PreventFocusLeave = true; //When CurrentCell moves to another Row, the action is done. focusProcess.DoActionReason = ValidateReasons.RowValidating; regularExpressionValidator.Actions.Add(focusProcess); template.Row.Cells[0].Validators.Add(regularExpressionValidator); this.gcMultiRow1.Template = template; label .Text = @"The RegularExpressionValidator.Expression is '^-?\d+(\.\d{2})?$', which expresses a currency value, input '-!2.05', then move CurrentCell to another Row to trigger validation (DoActionReasion is RowValidating), the focus cannot move, input '-12.05', the focus moves to another Row."; }
Private Sub setRegularExpressionValidator_Click(ByVal sender As Object, ByVal e As EventArgs) Handles setRegularExpressionValidator.Click Dim template As Template = template.CreateGridTemplate(1) Dim regularExpressionValidator As New RegularExpressionValidator() 'Define a regular expression for currency values. regularExpressionValidator.Expression = "^-?\d+(\.\d{2})?$" regularExpressionValidator.RegexOptions = System.Text.RegularExpressions.RegexOptions.CultureInvariant Dim focusProcess As New FocusProcess() focusProcess.PreventFocusLeave = True 'When CurrentCell moves to another Row, the action is done. focusProcess.DoActionReason = ValidateReasons.RowValidating regularExpressionValidator.Actions.Add(focusProcess) template.Row.Cells(0).Validators.Add(regularExpressionValidator) Me.gcMultiRow1.Template = template label.Text = "The RegularExpressionValidator.Expression is '^-?\d+(\.\d{2})?$', which expresses a currency value, input '-!2.05', then move CurrentCell to another Row to trigger validation (DoActionReasion is RowValidating), the focus cannot move, input '-12.05', the focus moves to another Row." End Sub
Inheritance Hierarchy
System.Object
GrapeCity.Win.MultiRow.CellValidator
GrapeCity.Win.MultiRow.RegularExpressionValidator
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
See Also