RegularExpressionAttribute Classe

Définition

Espace de noms:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.DataAnnotations.dll

Spécifie qu’une valeur de champ de données dans ASP.NET Données dynamiques doit correspondre à l’expression régulière spécifiée.

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

Héritage

Object

Attribute

ValidationAttribute

RegularExpressionAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant montre comment utiliser l’attribut RegularExpressionAttribute pour valider les champs de données FirstName et LastName. L’expression régulière autorise jusqu’à 40 caractères majuscules et minuscules. L’exemple effectue les tâches suivantes :

• Implémente une classe partielle de métadonnées et la classe de métadonnées associée.
• Dans la classe de métadonnées associée, applique l’attribut RegularExpressionAttribute aux champs de données FirstName et LastName, en spécifiant le modèle et les messages d’erreur personnalisés.

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

Remarques

Vous appliquez l’attribut RegularExpressionAttribute à une propriété lorsque vous devez valider les valeurs de la propriété par rapport à une expression régulière. L’expression régulière vous permet de spécifier très précisément le format des valeurs valides. La propriété Pattern contient l’expression régulière. Si la valeur de la propriété est Null ou une chaîne vide («  »), la valeur passe automatiquement la validation de l’attribut RegularExpressionAttribute. Pour vérifier que la valeur n’est pas ou n’est pas null une chaîne vide, utilisez l’attribut RequiredAttribute .

L’expression régulière recherche une correspondance exacte, sans utiliser ^ avant et $ à la fin du modèle produit les mêmes résultats que son utilisation. Pour un accès à la recherche, ajouté et ajoutez le modèle avec .*.

Constructeurs

Nom	Description
RegularExpressionAttribute(String)	Initialise une nouvelle instance de la classe RegularExpressionAttribute.

Propriétés

Nom	Description
ErrorMessage	Obtient ou définit un message d’erreur à associer à un contrôle de validation en cas d’échec de la validation. (Hérité de ValidationAttribute)
ErrorMessageResourceName	Obtient ou définit le nom de la ressource de message d’erreur à utiliser pour rechercher la valeur de propriété ErrorMessageResourceType en cas d’échec de la validation. (Hérité de ValidationAttribute)
ErrorMessageResourceType	Obtient ou définit le type de ressource à utiliser pour la recherche de message d’erreur en cas d’échec de la validation. (Hérité de ValidationAttribute)
ErrorMessageString	Obtient le message d’erreur de validation localisé. (Hérité de ValidationAttribute)
MatchTimeoutInMilliseconds	Obtient ou définit la durée en millisecondes pour exécuter une opération de correspondance unique avant l’expiration de l’opération.
Pattern	Obtient le modèle d’expression régulière.
RequiresValidationContext	Obtient une valeur qui indique si l’attribut nécessite un contexte de validation. (Hérité de ValidationAttribute)
TypeId	En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute. (Hérité de Attribute)

Méthodes

Nom	Description
Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
FormatErrorMessage(String)	Met en forme le message d’erreur à afficher si la validation d’expression régulière échoue.
GetHashCode()	Retourne le code de hachage pour cette instance. (Hérité de Attribute)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetValidationResult(Object, ValidationContext)	Vérifie si la valeur spécifiée est valide par rapport à l’attribut de validation actuel. (Hérité de ValidationAttribute)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut de la classe dérivée. (Hérité de Attribute)
IsValid(Object, ValidationContext)	Valide la valeur spécifiée par rapport à l’attribut de validation actuel. (Hérité de ValidationAttribute)
IsValid(Object)	Vérifie si la valeur entrée par l’utilisateur correspond au modèle d’expression régulière.
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
Validate(Object, String)	Valide l’objet spécifié. (Hérité de ValidationAttribute)
Validate(Object, ValidationContext)	Valide l’objet spécifié. (Hérité de ValidationAttribute)

Implémentations d’interfaces explicites

Nom	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Récupère les informations de type d’un objet, qui peuvent être utilisées pour obtenir les informations de type d’une interface. (Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fournit l’accès aux propriétés et méthodes exposées par un objet. (Hérité de Attribute)

Voir aussi

• Expressions régulières .NET