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.Specifies that a data field value in ASP.NET Dynamic Data must match the specified regular expression.

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
public class RegularExpressionAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute
[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)]
public class RegularExpressionAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute
type RegularExpressionAttribute = class
    inherit ValidationAttribute
Public Class RegularExpressionAttribute
Inherits ValidationAttribute
Herança
RegularExpressionAttribute
Atributos

Exemplos

O exemplo a seguir mostra como usar o atributo RegularExpressionAttribute para validar os campos de dados FirstName e LastName.The following example shows how to use the RegularExpressionAttribute attribute to validate the FirstName and LastName data fields. A expressão regular permite até 40 caracteres maiúsculos e minúsculos.The regular expression allows up to 40 uppercase and lowercase characters. O exemplo executa as seguintes tarefas:The example performs the following tasks:

  • Implementa uma classe parcial de metadados e a classe de metadados associada.Implements a metadata partial class and the associated metadata class.

  • Na classe de metadados associada, o aplica o atributo RegularExpressionAttribute aos campos de dados FirstName e LastName, especificando o padrão e as mensagens de erro personalizadas.In the associated metadata class, applies the RegularExpressionAttribute attribute to the FirstName and LastName data fields, specifying the pattern and custom error messages.

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.You apply the RegularExpressionAttribute attribute to a property when you need to validate values for the property against a regular expression. A expressão regular permite que você especifique muito precisamente o formato dos valores válidos.The regular expression enables you to specify very precisely the format of valid values. A propriedade Pattern contém a expressão regular.The Pattern property contains the regular expression. Se o valor da propriedade for nulo ou uma cadeia de caracteres vazia (""), o valor passará automaticamente a validação para o atributo RegularExpressionAttribute.If the value of the property is null or an empty string (""), the value automatically passes validation for the RegularExpressionAttribute attribute. Para validar que o valor não é null ou uma cadeia de caracteres vazia, use o atributo Requeridoattribute .To validate that the value is not null or an empty string, use the RequiredAttribute attribute.

A expressão regular procura uma correspondência exata, não usando ^ antes e $ no final do padrão produz os mesmos resultados que o utiliza.The regular expression searches for an exact match, not using ^ before and $ at the end of the pattern produces the same results as using it. Para uma visita de pesquisa, preceda e acrescente o padrão com .*.For a search hit, prepend and append the pattern with .*.

Construtores

RegularExpressionAttribute(String)

Inicializa uma nova instância da classe RegularExpressionAttribute.Initializes a new instance of the RegularExpressionAttribute class.

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.Gets or sets an error message to associate with a validation control if validation fails.

(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.Gets or sets the error message resource name to use in order to look up the ErrorMessageResourceType property value if validation fails.

(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.Gets or sets the resource type to use for error-message lookup if validation fails.

(Herdado de ValidationAttribute)
ErrorMessageString

Obtém a mensagem de erro de validação localizada.Gets the localized validation error message.

(Herdado de ValidationAttribute)
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.Gets or sets the amount of time in milliseconds to execute a single matching operation before the operation times out.

Pattern

Obtém o padrão da expressão regular.Gets the regular expression pattern.

RequiresValidationContext

Obtém ou define um valor que indica se o atributo requer contexto de validação.Gets a value that indicates whether the attribute requires validation context.

(Herdado de ValidationAttribute)
TypeId

Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Herdado de Attribute)

Métodos

Equals(Object)

Retorna um valor que indica se essa instância é igual a um objeto especificado.Returns a value that indicates whether this instance is equal to a specified object.

(Herdado de Attribute)
FormatErrorMessage(String)

Formata a mensagem de erro para exibir se a expressão regular de validação falhar.Formats the error message to display if the regular expression validation fails.

GetHashCode()

Retorna o código hash para a instância.Returns the hash code for this instance.

(Herdado de Attribute)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetValidationResult(Object, ValidationContext)

Verifica se o valor especificado é válido em relação ao atributo de validação atual.Checks whether the specified value is valid with respect to the current validation attribute.

(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.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Herdado de Attribute)
IsValid(Object)

Verifica se o valor inserido pelo usuário corresponde ao padrão de expressão regular.Checks whether the value entered by the user matches the regular expression pattern.

IsValid(Object, ValidationContext)

Valida o valor especificado em relação ao atributo de validação atual.Validates the specified value with respect to the current validation attribute.

(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.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Herdado de Attribute)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
Validate(Object, String)

Valida o objeto especificado.Validates the specified object.

(Herdado de ValidationAttribute)
Validate(Object, ValidationContext)

Valida o objeto especificado.Validates the specified object.

(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.Maps a set of names to a corresponding set of dispatch identifiers.

(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.Retrieves the type information for an object, which can be used to get the type information for an 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).Retrieves the number of type information interfaces that an object provides (either 0 or 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.Provides access to properties and methods exposed by an object.

(Herdado de Attribute)

Aplica-se a