RegularExpressionAttribute Classe

Definizione

Spazio dei nomi:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Origine:

RegularExpressionAttribute.cs

Specifica che il valore di un 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.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type RegularExpressionAttribute = class
    inherit ValidationAttribute

Public Class RegularExpressionAttribute
Inherits ValidationAttribute

Ereditarietà

Object

Attribute

ValidationAttribute

RegularExpressionAttribute

Attributi

AttributeUsageAttribute

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 dei metadati e la classe di metadati associata.

• Nella classe di metadati associata si applica l'attributo ai campi dati FirstName e LastName, specificando il RegularExpressionAttribute modello 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

Viene applicato l'attributo RegularExpressionAttribute a una proprietà quando è necessario convalidare i valori della proprietà in base 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 usando ^ prima e $ alla fine del modello produce gli stessi risultati dell'uso. Per un hit di ricerca, anteporre e aggiungere il modello con .*.

Costruttori

RegularExpressionAttribute(String)

Inizializza una nuova istanza della classe RegularExpressionAttribute.

Proprietà

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 di risorsa del messaggio di errore da utilizzare per la ricerca del valore della proprietà ErrorMessageResourceType se la convalida non riesce. (Ereditato da ValidationAttribute)
ErrorMessageResourceType	Ottiene o imposta il tipo di risorsa da utilizzare per la ricerca del messaggio di errore se la convalida non riesce. (Ereditato da ValidationAttribute)
ErrorMessageString	Ottiene il messaggio di errore di convalida localizzato. (Ereditato da ValidationAttribute)
MatchTimeout	Ottiene il timeout da usare quando corrisponde al modello di espressione regolare
MatchTimeoutInMilliseconds	Ottiene o imposta il periodo di tempo in millisecondi in cui eseguire una singola operazione di corrispondenza prima del timeout dell'operazione.
Pattern	Ottiene il modello di espressione regolare.
RequiresValidationContext	Ottiene un valore che indica se l'attributo richiede il contesto di convalida. (Ereditato da ValidationAttribute)
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)

Metodi

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 l'istanza. (Ereditato da Attribute)
GetType()	Ottiene l'oggetto 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()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
IsValid(Object)	Verifica se il valore immesso dall'utente corrisponde al modello di espressione regolare.
IsValid(Object, ValidationContext)	Convalida il valore specificato rispetto all'attributo di convalida corrente. (Ereditato da ValidationAttribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (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)