RegularExpressionAttribute Classe

Definição

Especifica que o valor de um campo de dados no Dados Dinâmicos do ASP.NET deve corresponder à expressão regular especificada.

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
RegularExpressionAttribute
Atributos

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 se 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, preenvia e acrescente o padrão com .*.

Construtores

RegularExpressionAttribute(String)

Inicializa uma nova instância da classe RegularExpressionAttribute.

Propriedades

ErrorMessage

Obtém ou define uma mensagem de erro para associar a um controle de validação em caso de falha da validação.

(Herdado de ValidationAttribute)
ErrorMessageResourceName

Obtém ou define o nome do recurso de mensagem de erro a ser usado para pesquisar o valor da propriedade ErrorMessageResourceType se a validação falhar.

(Herdado de ValidationAttribute)
ErrorMessageResourceType

Obtém ou define o tipo de recurso a ser usado para a pesquisa de mensagens de erro se a validação falhar.

(Herdado de ValidationAttribute)
ErrorMessageString

Obtém a mensagem de erro de validação localizada.

(Herdado de ValidationAttribute)
MatchTimeout

Obtém o tempo limite a ser usado ao corresponder ao padrão de expressão regular

MatchTimeoutInMilliseconds

Obtém ou define a quantidade de tempo em milissegundos para executar uma única operação de correspondência antes que o tempo limite da operação seja atingido.

Pattern

Obtém o padrão da expressão regular.

RequiresValidationContext

Obtém ou define um valor que indica se o atributo requer contexto de validação.

(Herdado de ValidationAttribute)
TypeId

Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute.

(Herdado de Attribute)

Métodos

Equals(Object)

Retorna um valor que indica se essa instância é igual a um objeto especificado.

(Herdado de Attribute)
FormatErrorMessage(String)

Formata a mensagem de erro para exibir se a expressão regular de validação falhar.

GetHashCode()

Retorna o código hash para a instância.

(Herdado de Attribute)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetValidationResult(Object, ValidationContext)

Verifica se o valor especificado é válido em relação ao atributo de validação atual.

(Herdado de ValidationAttribute)
IsDefaultAttribute()

Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada.

(Herdado de Attribute)
IsValid(Object)

Verifica se o valor inserido pelo usuário corresponde ao padrão de expressão regular.

IsValid(Object, ValidationContext)

Valida o valor especificado em relação ao atributo de validação atual.

(Herdado de ValidationAttribute)
Match(Object)

Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado.

(Herdado de Attribute)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
Validate(Object, String)

Valida o objeto especificado.

(Herdado de ValidationAttribute)
Validate(Object, ValidationContext)

Valida o objeto especificado.

(Herdado de ValidationAttribute)

Implantações explícitas de interface

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição.

(Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera as informações de tipo para um objeto, que pode ser usado para obter as informações de tipo para uma interface.

(Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1).

(Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornece acesso a propriedades e métodos expostos por um objeto.

(Herdado de Attribute)

Aplica-se a