RegularExpressionAttribute Classe

Definição

public ref class RegularExpressionAttribute : System::ComponentModel::DataAnnotations::ValidationAttribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)]
public class RegularExpressionAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)]
public class RegularExpressionAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type RegularExpressionAttribute = class
    inherit ValidationAttribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)>]
type RegularExpressionAttribute = class
    inherit ValidationAttribute

Public Class RegularExpressionAttribute
Inherits ValidationAttribute

Herança

Object

Attribute

ValidationAttribute

RegularExpressionAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo a seguir mostra como usar o RegularExpressionAttribute atributo para validar os campos de dados FirstName e LastName. A expressão regular permite até 40 caracteres maiúsculos e minúsculos. O exemplo executa as seguintes tarefas:

• Implementa uma classe parcial de metadados e a classe de metadados associada.
• Na classe de metadados associada, aplica o RegularExpressionAttribute atributo aos campos de dados FirstName e LastName, especificando o padrão e as mensagens de erro personalizadas.

using System;
using System.Web.DynamicData;
using System.ComponentModel.DataAnnotations;

[MetadataType(typeof(CustomerMetaData))]
public partial class Customer
{
}

public class CustomerMetaData
{
   
    // Allow up to 40 uppercase and lowercase 
    // characters. Use custom error.
    [RegularExpression(@"^[a-zA-Z''-'\s]{1,40}$", 
         ErrorMessage = "Characters are not allowed.")]
    public object FirstName;

    // Allow up to 40 uppercase and lowercase 
    // characters. Use standard error.
    [RegularExpression(@"^[a-zA-Z''-'\s]{1,40}$")]
    public object LastName;
}

Imports System.Web.DynamicData
Imports System.ComponentModel.DataAnnotations


<MetadataType(GetType(CustomerMetaData))> _
Partial Public Class Customer

    
End Class

Public Class CustomerMetaData
    
    ' Allow up to 40 uppercase and lowercase 
    ' characters. Use custom error.
    <RegularExpression("^[a-zA-Z''-'\s]{1,40}$", _
                       ErrorMessage:="Characters are not allowed.")> _
    Public FirstName As Object

    ' Allow up to 40 uppercase and lowercase 
    ' characters. Use standard error.
    <RegularExpression("^[a-zA-Z''-'\s]{1,40}$")> _
    Public LastName As Object
End Class

Comentários

Você aplica o atributo RegularExpressionAttribute a uma propriedade quando precisa validar valores para a propriedade em relação a uma expressão regular. A expressão regular permite que você especifique com precisão o formato de valores válidos. A propriedade Pattern contém a expressão regular. Se o valor da propriedade for nulo ou uma cadeia de caracteres vazia (""), o valor passará automaticamente a validação para o atributo RegularExpressionAttribute. Para validar que o valor não null é ou uma cadeia de caracteres vazia, use o atributo RequiredAttribute .

A expressão regular procura uma correspondência exata, não usando ^ antes e $ no final do padrão produz os mesmos resultados que usá-la. Para obter um hit de pesquisa, acrescente e acrescente o padrão com .*.

Confira também

• Expressões regulares do .NET