RegularExpressionAttribute Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Spécifie qu'une valeur de champ de données dans Dynamic Data ASP.NET 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.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
- Héritage
- Attributs
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 pour l’attribut RegularExpressionAttribute. Pour vérifier que la valeur n’est pas null
ou une chaîne vide, utilisez l’attribut RequiredAttribute .
L’expression régulière recherche une correspondance exacte, ne l’utilisant ^
pas avant et $
à la fin du modèle produit les mêmes résultats que son utilisation. Pour une recherche, ajoutez et ajoutez le modèle avec .*
.
Constructeurs
RegularExpressionAttribute(String) |
Initialise une nouvelle instance de la classe RegularExpressionAttribute. |
Propriétés
ErrorMessage |
Obtient ou définit un message d'erreur à associer à un contrôle de validation si la validation échoue. (Hérité de ValidationAttribute) |
ErrorMessageResourceName |
Obtient ou définit le nom de la ressource de message d'erreur à utiliser pour rechercher la valeur de la propriété ErrorMessageResourceType si la validation échoue. (Hérité de ValidationAttribute) |
ErrorMessageResourceType |
Obtient ou définit le type de ressource à utiliser pour la recherche de message d'erreur si une validation échoue. (Hérité de ValidationAttribute) |
ErrorMessageString |
Obtient le message d'erreur de validation localisé. (Hérité de ValidationAttribute) |
MatchTimeout |
Obtient le délai d’expiration à utiliser lors de la correspondance avec le modèle d’expression régulière |
MatchTimeoutInMilliseconds |
Obtient ou définit la durée en millisecondes pour exécuter une seule opération de correspondance 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 requiert un contexte de validation. (Hérité de ValidationAttribute) |
TypeId |
Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute) |
Méthodes
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 en cas d'échec de validation de l'expression régulière. |
GetHashCode() |
Retourne le code de hachage de cette instance. (Hérité de Attribute) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
GetValidationResult(Object, ValidationContext) |
Vérifie si la valeur spécifiée est valide en tenant compte de 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 pour la classe dérivée. (Hérité de Attribute) |
IsValid(Object) |
Vérifie si la valeur entrée par l'utilisateur correspond au modèle d'expression régulière. |
IsValid(Object, ValidationContext) |
Valide la valeur spécifiée en tenant compte de l'attribut de validation actuel. (Hérité de ValidationAttribute) |
Match(Object) |
En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (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
_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 pour 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 aux méthodes exposées par un objet. (Hérité de Attribute) |