VerificationAttribute Classe

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

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.

Définit l'attribut de métadonnées de la règle d'accessibilité d'un contenu Web. Cette classe ne peut pas être héritée.

public ref class VerificationAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Property, AllowMultiple=true)]
public sealed class VerificationAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Property, AllowMultiple=true)>]
type VerificationAttribute = class
    inherit Attribute

Public NotInheritable Class VerificationAttribute
Inherits Attribute

Héritage: Object

Attribute
VerificationAttribute

Attributs: AttributeUsageAttribute

Exemples

L’exemple de code suivant illustre l’utilisation de la VerificationAttribute classe . Dans la définition des métadonnées de vérification, les directives utilisées sont « WCAG », les lignes directrices sur l’accessibilité du contenu web et « ADA », les directives de la Loi américaines sur les handicaps. Pour plus d’informations, consultez le site Web du World Wide Web Consortium (W3C).

Les points de contrôle utilisés sont respectivement « 1.1 » et « 1194.22(a) » pour WCAG et ADA, des points de contrôle permettant de garantir l’existence d’un équivalent texte pour les éléments non textuels. VerificationAttribute est appliqué à la ImageText propriété qui représente l’équivalent de texte d’une autre propriété appelée ImageProperty. Si la ImageText propriété n’est pas définie, la vérification d’accessibilité retourne le message « Il manque un équivalent texte à l’image ».

[Verification("ADA", "1194.22(a)", 
    VerificationReportLevel.Error, 1,
    "The image is missing a text equivalent.", 
    VerificationRule.NotEmptyString, "ImageUrl"),
Verification("WCAG", "1.1", 
    VerificationReportLevel.Error, 1, 
    "The image is missing an text equivalent.", 
    VerificationRule.NotEmptyString, "ImageUrl")]
public virtual String ImageText
{
    get
    {
        object obj = ViewState["ImageText"];
        return ((obj == null) ? String.Empty : (string)obj);
    }
    set
    {
        ViewState["ImageText"] = value;
    }
}
public virtual String ImageUrl
{
    get 
    {
        object obj = ViewState["ImageUrl"];
        return ((obj == null) ? String.Empty : (string)obj);
    }
    set 
    { 
        ViewState["ImageUrl"] = value;
    }
}

<Verification("ADA", "1194.22(a)", VerificationReportLevel.Error, 1, "The image is missing a text equivalent.", VerificationRule.NotEmptyString, "ImageUrl")> _
<Verification("WCAG", "1.1", VerificationReportLevel.Error, 1, "The image is missing a text equivalent.", VerificationRule.NotEmptyString, "ImageUrl")> _
Public Property ImageText() As String
    Get
        If ViewState("ImageText") Is Nothing Then
            Return String.Empty
        Else
            Return CType(ViewState("ImageText"), String)
        End If
    End Get
    Set(ByVal value As String)
        ViewState("ImageText") = value
    End Set
End Property


Public Property ImageUrl() As String
    Get
        If ViewState("ImageUrl") Is Nothing Then
            Return String.Empty
        Else
            Return CType(ViewState("ImageUrl"), String)
        End If
    End Get
    Set(ByVal value As String)
        ViewState("ImageUrl") = value
    End Set
End Property

Remarques

Une instance de la VerificationAttribute classe définit une règle d’accessibilité du contenu web qui peut être vérifiée. Pour plus d’informations sur les directives d’accessibilité du contenu web, consultez le site Web du World Wide Web Consortium (W3C).

La quantité minimale d’informations requises pour définir une instance d’un VerificationAttribute inclut :

Ligne directrice que la règle de vérification représente. La valeur spécifiée dans le constructeur définit la Guideline propriété .
Point de contrôle de la ligne directrice. La valeur spécifiée dans le constructeur définit la Checkpoint propriété .
Priorité de point de contrôle. La valeur spécifiée dans le constructeur définit la Priority propriété .
Valeur VerificationReportLevel d’énumération qui représente le niveau de rapport auquel la règle doit appartenir. La valeur spécifiée dans le constructeur définit la VerificationReportLevel propriété .
Message signalé lorsque la règle de vérification est vraie. La valeur spécifiée dans le constructeur définit la Message propriété .

Propriétés facultatives de la règle de vérification qui peuvent être spécifiées lors de la création d’une instance :

Valeur VerificationRule d’énumération qui représente la façon dont la règle de vérification doit être interprétée. La valeur spécifiée dans le constructeur définit la VerificationRule propriété .
Valeur VerificationConditionalOperator d’énumération qui représente l’opérateur dans l’expression conditionnelle utilisée pour tester la règle de vérification. La valeur spécifiée dans le constructeur définit la VerificationConditionalOperator propriété .
URL de référence sur l’accessibilité. La valeur spécifiée dans le constructeur définit la GuidelineUrl propriété .
Valeur conditionnelle représentant le côté droit d’une expression conditionnelle. La valeur spécifiée dans le constructeur définit la ConditionalValue propriété .
Propriété conditionnelle représentant le côté gauche d’une expression conditionnelle. La valeur spécifiée dans le constructeur définit la ConditionalProperty propriété .

Les VerificationAttribute métadonnées peuvent être définies comme des déclarations de classe, de propriété et d’indexeur.

Pour plus d’informations sur l’utilisation des attributs, consultez Attributs.

Constructeurs

VerificationAttribute(String, String, VerificationReportLevel, Int32, String)	Initialise une nouvelle instance de la classe VerificationAttribute avec la règle d'accessibilité, le point de contrôle, le niveau de rapport, la priorité de point de contrôle et le message d'erreur.
VerificationAttribute(String, String, VerificationReportLevel, Int32, String, VerificationRule, String)	Initialise une nouvelle instance de la classe VerificationAttribute avec la règle d'accessibilité, le point de contrôle, le niveau de création de rapports, la priorité de point de contrôle, le message d'erreur, la valeur VerificationRule et la propriété conditionnelle connexe.
VerificationAttribute(String, String, VerificationReportLevel, Int32, String, VerificationRule, String, VerificationConditionalOperator, String, String)	Initialise une nouvelle instance de la classe VerificationAttribute avec la règle d'accessibilité, le point de contrôle, le niveau de création de rapports, la priorité de point de contrôle, le message d'erreur, la valeur VerificationRule, la propriété conditionnelle connexe, une valeur de propriété conditionnelle connexe, et une URL de l'indication de la référence.

Propriétés

Checkpoint	Obtient la référence du point de contrôle d'accessibilité dans la propriété Guideline spécifiée.
ConditionalProperty	Obtient le côté gauche d'une expression conditionnelle utilisée dans le cadre du point de contrôle de l'accessibilité de la vérification.
ConditionalValue	Obtient le côté droit d'une expression conditionnelle utilisée dans le cadre du point de contrôle de l'accessibilité de la vérification.
Guideline	Obtient l'indication utilisée pour le contrôle d'accessibilité.
GuidelineUrl	Obtient l'URL permettant d'obtenir davantage d'informations sur les règles d'accessibilité fournie par la propriété Guideline.
Message	Obtient une chaîne de message lorsque la règle de la vérification du point de contrôle de l'accessibilité a la valeur true.
Priority	Obtient la priorité du point de contrôle de l'accessibilité.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)
VerificationConditionalOperator	Obtient une valeur d'énumération VerificationConditionalOperator indiquant comment le point de contrôle de l'accessibilité est vérifié.
VerificationReportLevel	Obtient une valeur d'énumération VerificationReportLevel indiquant comment le point de contrôle de l'accessibilité est utilisé.
VerificationRule	Obtient une valeur d'énumération VerificationRule indiquant comment le point de contrôle de l'accessibilité est utilisé.

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
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)
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)
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)

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)

S’applique à

Voir aussi

Extension des métadonnées à l'aide des attributs