VerificationAttribute Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI

Assembly:: System.Web.dll

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.

Definisce l'attributo di metadati di una regola di accessibilità per il contenuto Web. La classe non può essere ereditata.

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

Ereditarietà: Object

Attribute
VerificationAttribute

Attributi: AttributeUsageAttribute

Esempio

Nell'esempio di codice seguente viene illustrato l'uso della VerificationAttribute classe . Nella definizione dei metadati di verifica le linee guida usate sono "WCAG", le linee guida per l'accessibilità del contenuto Web e "ADA", gli americani con disabilità Act Linee guida. Per altre informazioni, vedere il sito Web World Wide Web Consortium (W3C).

I checkpoint usati sono rispettivamente "1.1" e "1194.22(a)" per WCAG e ADA, rispettivamente, checkpoint per garantire che esista un equivalente di testo per gli elementi non testuali. Viene VerificationAttribute applicato alla proprietà che rappresenta l'equivalente ImageText di testo di un'altra proprietà denominata ImageProperty. Se la ImageText proprietà non è impostata, la verifica di accessibilità restituirà il messaggio "L'immagine manca un equivalente di testo".

[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

Commenti

Un'istanza VerificationAttribute della classe definisce una regola di accessibilità del contenuto Web che può essere verificata. Per altre informazioni sulle linee guida sull'accessibilità del contenuto Web, vedere il sito Web World Wide Web Consortium (W3C).

Quantità minima di informazioni necessarie per definire un'istanza di un VerificationAttribute include:

Linee guida rappresentate dalla regola di verifica. Il valore specificato nel costruttore imposta la Guideline proprietà.
Checkpoint delle linee guida. Il valore specificato nel costruttore imposta la Checkpoint proprietà.
Priorità del checkpoint. Il valore specificato nel costruttore imposta la Priority proprietà.
Valore VerificationReportLevel di enumerazione che rappresenta il livello di report a cui deve appartenere la regola. Il valore specificato nel costruttore imposta la VerificationReportLevel proprietà.
Messaggio segnalato quando la regola di verifica è true. Il valore specificato nel costruttore imposta la Message proprietà.

Proprietà facoltative della regola di verifica che può essere specificata durante la creazione di un'istanza:

Valore VerificationRule di enumerazione che rappresenta il modo in cui deve essere interpretata la regola di verifica. Il valore specificato nel costruttore imposta la VerificationRule proprietà.
Valore VerificationConditionalOperator di enumerazione che rappresenta l'operatore nell'espressione condizionale usata per testare la regola di verifica. Il valore specificato nel costruttore imposta la VerificationConditionalOperator proprietà.
URL delle linee guida di riferimento per l'accessibilità. Il valore specificato nel costruttore imposta la GuidelineUrl proprietà.
Valore condizionale che rappresenta il lato destro di un'espressione condizionale. Il valore specificato nel costruttore imposta la ConditionalValue proprietà.
Proprietà condizionale che rappresenta il lato sinistro di un'espressione condizionale. Il valore specificato nel costruttore imposta la ConditionalProperty proprietà.

I VerificationAttribute metadati possono essere definiti dichiarazioni di classe, proprietà e indicizzatore.

Per altre informazioni sull'uso degli attributi, vedere Attributi.

Costruttori

VerificationAttribute(String, String, VerificationReportLevel, Int32, String)	Inizializza una nuova istanza della classe VerificationAttribute con le linee guida per l'accessibilità, il punto di controllo, il livello di segnalazione, la priorità del punto di controllo e un messaggio di errore.
VerificationAttribute(String, String, VerificationReportLevel, Int32, String, VerificationRule, String)	Inizializza una nuova istanza della classe VerificationAttribute con le linee guida per l'accessibilità, il punto di controllo, il livello di segnalazione, la priorità del punto di controllo, un messaggio di errore, il valore di VerificationRule e la proprietà condizionale correlata.
VerificationAttribute(String, String, VerificationReportLevel, Int32, String, VerificationRule, String, VerificationConditionalOperator, String, String)	Inizializza una nuova istanza della classe VerificationAttribute con le linee guida per l'accessibilità, il punto di controllo, il livello di segnalazione, la priorità del punto di controllo, un messaggio di errore, il valore di VerificationRule, il valore di una proprietà condizionale correlata e l'URL delle linee guida di riferimento.

Proprietà

Checkpoint	Ottiene il riferimento al punto di controllo di accessibilità nella proprietà Guideline specificata.
ConditionalProperty	Ottiene la parte sinistra di un'espressione condizionale utilizzata nell'ambito del punto di controllo di verifica per l'accessibilità.
ConditionalValue	Ottiene la parte destra di un'espressione condizionale utilizzata nell'ambito del punto di controllo di verifica per l'accessibilità.
Guideline	Ottiene le linee guida utilizzate per la verifica dell'accessibilità.
GuidelineUrl	Ottiene l'URL che può essere utilizzato per ottenere ulteriori informazioni sulle linee guida per l'accessibilità specificate dalla proprietà Guideline.
Message	Ottiene una stringa di messaggio se la regola di verifica del punto di controllo è true.
Priority	Ottiene la priorità del punto di controllo dell'accessibilità.
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)
VerificationConditionalOperator	Ottiene un valore dell'enumerazione di VerificationConditionalOperator che indica come viene verificato il punto di controllo dell'accessibilità.
VerificationReportLevel	Ottiene un valore dell'enumerazione di VerificationReportLevel che indica come viene utilizzato il punto di controllo dell'accessibilità.
VerificationRule	Ottiene un valore dell'enumerazione di VerificationRule che indica come viene utilizzato il punto di controllo dell'accessibilità.

Metodi

Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

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. (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. (Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera il numero delle 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 a proprietà e metodi esposti da un oggetto. (Ereditato da Attribute)

Si applica a

Vedi anche

Estensione di metadati mediante attributi