RegularExpressionAttribute Classe

Definizione

Specifica che un valore di campo dati in ASP.NET Dynamic Data deve corrispondere all'espressione regolare specificata.

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
Ereditarietà
RegularExpressionAttribute
Attributi

Esempio

Nell'esempio seguente viene illustrato come usare l'attributo RegularExpressionAttribute per convalidare i campi dati FirstName e LastName. L'espressione regolare consente fino a 40 caratteri maiuscoli e minuscoli. Nell'esempio vengono eseguite le attività seguenti:

  • Implementa una classe parziale di metadati e la classe di metadati associata.
  • Nella classe di metadati associata, applica l'attributo RegularExpressionAttribute ai campi dati FirstName e LastName, specificando il criterio e i messaggi di errore personalizzati.
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

Commenti

Applicare l'attributo RegularExpressionAttribute a una proprietà quando è necessario convalidare i valori per la proprietà rispetto a un'espressione regolare. L'espressione regolare consente di specificare in modo molto preciso il formato dei valori validi. La proprietà Pattern contiene l'espressione regolare. Se il valore della proprietà è null o una stringa vuota (""), il valore passa automaticamente la convalida per l'attributo RegularExpressionAttribute. Per verificare che il valore non null sia o una stringa vuota, usare l'attributo RequiredAttribute .

L'espressione regolare cerca una corrispondenza esatta, non utilizzando ^ prima e $ alla fine del criterio produce gli stessi risultati dell'uso. Per un hit di ricerca, anteporre e aggiungere il criterio con .*.

Costruttori

Nome Descrizione
RegularExpressionAttribute(String)

Inizializza una nuova istanza della classe RegularExpressionAttribute.

Proprietà

Nome Descrizione
ErrorMessage

Ottiene o imposta un messaggio di errore da associare a un controllo di convalida se la convalida non riesce.

(Ereditato da ValidationAttribute)
ErrorMessageResourceName

Ottiene o imposta il nome della risorsa del messaggio di errore da utilizzare per cercare il valore della ErrorMessageResourceType proprietà in caso di esito negativo della convalida.

(Ereditato da ValidationAttribute)
ErrorMessageResourceType

Ottiene o imposta il tipo di risorsa da utilizzare per la ricerca di messaggi di errore in caso di esito negativo della convalida.

(Ereditato da ValidationAttribute)
ErrorMessageString

Ottiene il messaggio di errore di convalida localizzato.

(Ereditato da ValidationAttribute)
MatchTimeoutInMilliseconds

Ottiene o imposta la quantità di tempo in millisecondi per eseguire una singola operazione di corrispondenza prima del timeout dell'operazione.

Pattern

Ottiene il criterio di espressione regolare.

RequiresValidationContext

Ottiene un valore che indica se l'attributo richiede il contesto di convalida.

(Ereditato da ValidationAttribute)
TypeId

Se implementato in una classe derivata, ottiene un identificatore univoco per questo Attribute.

(Ereditato da Attribute)

Metodi

Nome Descrizione
Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.

(Ereditato da Attribute)
FormatErrorMessage(String)

Formatta il messaggio di errore da visualizzare se la convalida dell'espressione regolare non riesce.

GetHashCode()

Restituisce il codice hash per questa istanza.

(Ereditato da Attribute)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
GetValidationResult(Object, ValidationContext)

Verifica se il valore specificato è valido rispetto all'attributo di convalida corrente.

(Ereditato da ValidationAttribute)
IsDefaultAttribute()

Quando sottoposto a override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.

(Ereditato da Attribute)
IsValid(Object, ValidationContext)

Convalida il valore specificato rispetto all'attributo di convalida corrente.

(Ereditato da ValidationAttribute)
IsValid(Object)

Controlla se il valore immesso dall'utente corrisponde al criterio di espressione regolare.

Match(Object)

Quando sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
Validate(Object, String)

Convalida l'oggetto specificato.

(Ereditato da ValidationAttribute)
Validate(Object, ValidationContext)

Convalida l'oggetto specificato.

(Ereditato da ValidationAttribute)

Implementazioni dell'interfaccia esplicita

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

Esegue il mapping di un set di nomi a un set corrispondente di identificatori dispatch.

(Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo per un oggetto, che può essere utilizzato per ottenere le informazioni sul tipo per un'interfaccia.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero di interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).

(Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso alle proprietà e ai metodi esposti da un oggetto .

(Ereditato da Attribute)

Si applica a

Vedi anche