RegularExpressionAttribute Clase

Definición

Espacio de nombres:

System.ComponentModel.DataAnnotations

Ensamblado:

System.ComponentModel.DataAnnotations.dll

Especifica que un valor de campo de datos en ASP.NET Datos dinámicos 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.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type RegularExpressionAttribute = class
    inherit ValidationAttribute

Public Class RegularExpressionAttribute
Inherits ValidationAttribute

Herencia

Object

Attribute

ValidationAttribute

RegularExpressionAttribute

Atributos

AttributeUsageAttribute

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

Se aplica el atributo RegularExpressionAttribute a una propiedad cuando es necesario validar los valores de la propiedad en una expresión regular. La expresión regular permite especificar con 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 usando ^ antes y $ al final del patrón produce los mismos resultados que usarlos. Para obtener un acierto de búsqueda, anteponga y anexe el patrón con .*.

Constructores

Nombre	Description
RegularExpressionAttribute(String)	Inicializa una nueva instancia de la clase RegularExpressionAttribute.

Propiedades

Nombre	Description
ErrorMessage	Obtiene o establece un mensaje de error que se va a asociar a un control de validación si se produce un error en la validación. (Heredado de ValidationAttribute)
ErrorMessageResourceName	Obtiene o establece el nombre del recurso del mensaje de error que se va a usar para buscar el valor de la propiedad si se produce un error en la ErrorMessageResourceType validación. (Heredado de ValidationAttribute)
ErrorMessageResourceType	Obtiene o establece el tipo de recurso que se va a usar para la búsqueda de mensajes de error si se produce un error en la validación. (Heredado de ValidationAttribute)
ErrorMessageString	Obtiene el mensaje de error de validación localizado. (Heredado de ValidationAttribute)
MatchTimeoutInMilliseconds	Obtiene o establece la cantidad de tiempo en milisegundos para ejecutar una sola operación coincidente antes de que se agote el tiempo de espera de la operación.
Pattern	Obtiene el patrón 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

Nombre	Description
Equals(Object)	Devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
FormatErrorMessage(String)	Da formato al mensaje de error para mostrar si se produce un error en la validación de expresiones regulares.
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()	Cuando 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, ValidationContext)	Valida el valor especificado con respecto al atributo de validación actual. (Heredado de ValidationAttribute)
IsValid(Object)	Comprueba si el valor especificado por el usuario coincide con el patrón de expresión regular.
Match(Object)	Cuando se reemplaza 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 Objectactual. (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

Nombre	Description
_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)	Recupera la información de tipo de un objeto, que se puede usar para obtener la información de tipo 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 propiedades y métodos expuestos por un objeto . (Heredado de Attribute)

Consulte también

• Expresiones regulares de .NET