RegularExpressionAttribute Clase

Definición

Espacio de nombres:

System.ComponentModel.DataAnnotations

Ensamblado:

System.ComponentModel.Annotations.dll

Source:

RegularExpressionAttribute.cs

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.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

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)