RuleRegularExpressionAttribute Class

Defines a validation rule that demands the target property match a specified pattern.

Namespace: DevExpress.Persistent.Validation

Assembly: DevExpress.Persistent.Base.v25.2.dll

NuGet Package: DevExpress.Persistent.Base

Declaration

C#

[AttributeUsage(AttributeTargets.Property, AllowMultiple = true)]
public class RuleRegularExpressionAttribute :
    RuleBaseAttribute,
    IRuleRegularExpressionProperties,
    IRulePropertyValueProperties,
    IRuleCollectionPropertyProperties,
    IRuleBaseProperties

VB.NET

<AttributeUsage(AttributeTargets.Property, AllowMultiple:=True)>
Public Class RuleRegularExpressionAttribute
    Inherits RuleBaseAttribute
    Implements IRuleRegularExpressionProperties,
               IRulePropertyValueProperties,
               IRuleCollectionPropertyProperties,
               IRuleBaseProperties

Remarks

Apply this attribute to a business class string property to define a validation rule that will check whether this property’s value matches a specified regular expression. Use the pattern parameter to specify the regular expression that the property must match. In addition, use the common parameters that are inherited from the RuleBaseAttribute class.

C# (EF Core)

[RuleRegularExpression("",DefaultContexts.Save,
    @"^([\w-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$")]
public virtual string Email { get; set; }

// Make sure that you use options.UseChangeTrackingProxies() in your DbContext settings.

C# (XPO)

//...
private string email;
[RuleRegularExpression("",DefaultContexts.Save,
    @"^([\w-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$")]
public string Email {
   get { return email; }
   set { SetPropertyValue(nameof(Email), ref email, value); }
}
//...

VB.NET (XPO)

'...
Private fEmail As String
Private _email As String
<RuleRegularExpression("",DefaultContexts.Save, _
"^([\w-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$")> _
Public Property Email() As String
   Get
       Return _email
   End Get
   Set(ByVal value As String)
       SetPropertyValue(NameOf(Email), _email, value)
   End Set
End Property
Public Property Email() As String
   Get
      Return fEmail
   End Get
   Set
      SetPropertyValue(NameOf(Email), fEmail, Value)
   End Set
End Property
'...

The rule generated by the RuleRegularExpressionAttribute will be loaded to the Application Model‘s IModelValidationRules node. So, you can customize this rule via the Model Editor. In addition, you can create new rules in the Model Editor as well. This is helpful when you need to add a rule to a property which is implemented in a base class provided by a third party library. For details, refer to the Implement Property Value Validation topic.

Tip

You can find examples of this functionality in the MainDemo demo included with XAF. The demo illustrates various XAF features (including RuleRegularExpression and other validation attributes) and is located in the %PUBLIC%\Documents\DevExpress Demos 25.2\Components\XAF\MainDemo.NET.EFCore folder.

Implements

IRuleCollectionPropertyProperties

IRuleBaseProperties

Inheritance

Object

Attribute

RuleBaseAttribute

RuleRegularExpressionAttribute