RegularExpressionAttribute Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- 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) |