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 seguinte mostra como usar o RegularExpressionAttribute atributo para validar os campos de dados Primeiro Nome e Apelido. 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-se o RegularExpressionAttribute atributo aos campos de dados Primeiro Nome e Apelido, especificando o padrão e 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

Observações

Aplica-se o atributo RegularExpressionAttribute a uma propriedade quando é necessário validar valores dessa propriedade contra uma expressão regular. A expressão regular permite-lhe especificar com muita precisão o formato dos valores válidos. A propriedade Pattern contém a expressão regular. Se o valor da propriedade for nulo ou uma cadeia vazia (""), o valor passa automaticamente a validação para o atributo RegularExpressionAttribute. Para validar que o valor não null é ou uma cadeia vazia, use o atributo RequiredAttribute .

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

Ver também

• Expressões regulares do .NET