RegularExpressionAttribute Clase

Definición

Especifica que un valor de campo de datos en los datos dinámicos de ASP.NET debe coincidir con la expresión 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
Herencia
RegularExpressionAttribute
Atributos

Ejemplos

En el ejemplo siguiente se muestra cómo usar el RegularExpressionAttribute atributo para validar los campos de datos FirstName y LastName. La expresión regular permite hasta 40 caracteres en mayúsculas y minúsculas. En el ejemplo se realizan las siguientes tareas:

  • Implementa una clase parcial de metadatos y la clase de metadatos asociada.

  • En la clase de metadatos asociada, aplica el RegularExpressionAttribute atributo a los campos de datos FirstName y LastName, especificando el patrón y los mensajes de error personalizados.

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

Comentarios

El atributo RegularExpressionAttribute se aplica a una propiedad cuando es necesario validar los valores de la propiedad en una expresión regular. La expresión regular permite especificar con mucha precisión el formato de los valores válidos. La propiedad Pattern contiene la expresión regular. Si el valor de la propiedad es null o una cadena vacía (""), el valor pasa automáticamente la validación del atributo RegularExpressionAttribute. Para validar que el valor no null es o una cadena vacía, use el atributo RequiredAttribute .

La expresión regular busca una coincidencia exacta, no se usa ^ antes y $ al final del patrón se generan los mismos resultados que usarlos. Para un acierto de búsqueda, anteponga y anexe el patrón con .*.

Constructores

RegularExpressionAttribute(String)

Inicializa una nueva instancia de la clase RegularExpressionAttribute.

Propiedades

ErrorMessage

Obtiene o establece un mensaje de error que se va a asociar a un control de validación si se produce un error de validación.

(Heredado de ValidationAttribute)
ErrorMessageResourceName

Obtiene o establece el nombre de recurso del mensaje de error que se va a usar para buscar el valor de la propiedad ErrorMessageResourceType si se produce un error en la validación.

(Heredado de ValidationAttribute)
ErrorMessageResourceType

Obtiene o establece el tipo de recurso que se va a usar para buscar el mensaje de error si se produce un error de validación.

(Heredado de ValidationAttribute)
ErrorMessageString

Obtiene el mensaje de error de validación traducido.

(Heredado de ValidationAttribute)
MatchTimeout

Obtiene el tiempo de espera que se va a usar cuando coincida con el patrón de expresión regular.

MatchTimeoutInMilliseconds

Obtiene o establece el tiempo disponible en milisegundos para ejecutar una única operación coincidente antes de que se agote el tiempo de espera de la operación.

Pattern

Obtiene el modelo de expresión regular.

RequiresValidationContext

Obtiene un valor que indica si el atributo requiere contexto de validación.

(Heredado de ValidationAttribute)
TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.

(Heredado de Attribute)

Métodos

Equals(Object)

Devuelve un valor que indica si esta instancia es igual que un objeto especificado.

(Heredado de Attribute)
FormatErrorMessage(String)

Da formato al mensaje de error que debe mostrarse si se produce un error de validación de la expresión regular.

GetHashCode()

Devuelve el código hash de esta instancia.

(Heredado de Attribute)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
GetValidationResult(Object, ValidationContext)

Comprueba si el valor especificado es válido con respecto al atributo de validación actual.

(Heredado de ValidationAttribute)
IsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.

(Heredado de Attribute)
IsValid(Object)

Comprueba si el valor escrito por el usuario coincide con el modelo de expresión regular.

IsValid(Object, ValidationContext)

Valida el valor especificado con respecto al atributo de validación actual.

(Heredado de ValidationAttribute)
Match(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.

(Heredado de Attribute)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
Validate(Object, String)

Valida el objeto especificado.

(Heredado de ValidationAttribute)
Validate(Object, ValidationContext)

Valida el objeto especificado.

(Heredado de ValidationAttribute)

Implementaciones de interfaz explícitas

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

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.

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

Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz.

(Heredado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).

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

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.

(Heredado de Attribute)

Se aplica a