RegularExpressionAttribute Classe

Definizione

Specifica che il valore di un campo dati in ASP.NET Dynamic Data deve corrispondere all'espressione regolare specificata.Specifies that a data field value in ASP.NET Dynamic Data must match the specified regular expression.

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
type RegularExpressionAttribute = class
    inherit ValidationAttribute
Public Class RegularExpressionAttribute
Inherits ValidationAttribute
Ereditarietà
RegularExpressionAttribute
Attributi

Esempi

Nell'esempio seguente viene illustrato come utilizzare l'attributo RegularExpressionAttribute per convalidare i campi dati FirstName e LastName.The following example shows how to use the RegularExpressionAttribute attribute to validate the FirstName and LastName data fields. L'espressione regolare consente fino a 40 caratteri maiuscoli e minuscoli.The regular expression allows up to 40 uppercase and lowercase characters. Nell'esempio vengono eseguite le attività seguenti:The example performs the following tasks:

  • Implementa una classe parziale dei metadati e la classe di metadati associata.Implements a metadata partial class and the associated metadata class.

  • Nella classe di metadati associata, applica l'attributo RegularExpressionAttribute ai campi dati FirstName e LastName, specificando il modello e i messaggi di errore personalizzati.In the associated metadata class, applies the RegularExpressionAttribute attribute to the FirstName and LastName data fields, specifying the pattern and custom error messages.

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.You apply the RegularExpressionAttribute attribute to a property when you need to validate values for the property against a regular expression. L'espressione regolare consente di specificare con precisione il formato dei valori validi.The regular expression enables you to specify very precisely the format of valid values. La proprietà pattern contiene l'espressione regolare.The Pattern property contains the regular expression. Se il valore della proprietà è null o una stringa vuota (""), il valore passa automaticamente la convalida per l'attributo RegularExpressionAttribute.If the value of the property is null or an empty string (""), the value automatically passes validation for the RegularExpressionAttribute attribute. Per convalidare che il valore non sia null o una stringa vuota, usare l'attributo RequiredAttribute .To validate that the value is not null or an empty string, use the RequiredAttribute attribute.

L'espressione regolare cerca una corrispondenza esatta, non usando ^ prima e $ alla fine del modello produce gli stessi risultati che usano.The regular expression searches for an exact match, not using ^ before and $ at the end of the pattern produces the same results as using it. Per un hit di ricerca, anteporre e accodare il modello con .*.For a search hit, prepend and append the pattern with .*.

Costruttori

RegularExpressionAttribute(String)

Inizializza una nuova istanza della classe RegularExpressionAttribute.Initializes a new instance of the RegularExpressionAttribute class.

Proprietà

ErrorMessage

Ottiene o imposta un messaggio di errore da associare a un controllo di convalida se la convalida non riesce.Gets or sets an error message to associate with a validation control if validation fails.

(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.Gets or sets the error message resource name to use in order to look up the ErrorMessageResourceType property value if validation fails.

(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.Gets or sets the resource type to use for error-message lookup if validation fails.

(Ereditato da ValidationAttribute)
ErrorMessageString

Ottiene il messaggio di errore di convalida localizzato.Gets the localized validation error message.

(Ereditato da ValidationAttribute)
MatchTimeoutInMilliseconds

Ottiene o imposta il periodo di tempo in millisecondi in cui eseguire una singola operazione di corrispondenza prima del timeout dell'operazione.Gets or sets the amount of time in milliseconds to execute a single matching operation before the operation times out.

Pattern

Ottiene il modello di espressione regolare.Gets the regular expression pattern.

RequiresValidationContext

Ottiene un valore che indica se l'attributo richiede il contesto di convalida.Gets a value that indicates whether the attribute requires validation context.

(Ereditato da ValidationAttribute)
TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Ereditato da Attribute)

Metodi

Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.Returns a value that indicates whether this instance is equal to a specified object.

(Ereditato da Attribute)
FormatErrorMessage(String)

Formatta il messaggio di errore da visualizzare se la convalida dell'espressione regolare non riesce.Formats the error message to display if the regular expression validation fails.

GetHashCode()

Restituisce il codice hash per l'istanza.Returns the hash code for this instance.

(Ereditato da Attribute)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
GetValidationResult(Object, ValidationContext)

Verifica se il valore specificato è valido rispetto all'attributo di convalida corrente.Checks whether the specified value is valid with respect to the current validation attribute.

(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.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Ereditato da Attribute)
IsValid(Object)

Verifica se il valore immesso dall'utente corrisponde al modello di espressione regolare.Checks whether the value entered by the user matches the regular expression pattern.

IsValid(Object, ValidationContext)

Convalida il valore specificato rispetto all'attributo di convalida corrente.Validates the specified value with respect to the current validation attribute.

(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.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
Validate(Object, String)

Convalida l'oggetto specificato.Validates the specified object.

(Ereditato da ValidationAttribute)
Validate(Object, ValidationContext)

Convalida l'oggetto specificato.Validates the specified object.

(Ereditato da ValidationAttribute)

Implementazioni dell'interfaccia esplicita

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

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

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

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

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

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Ereditato da Attribute)

Si applica a