VerificationAttribute Klasse

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Definiert das Metadaten-Attribut einer Barrierefreiheitsregel für Webinhalt. Diese Klasse kann nicht vererbt werden.

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

Vererbung: Object

Attribute
VerificationAttribute

Attribute: AttributeUsageAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der VerificationAttribute -Klasse veranschaulicht. In der Definition der Überprüfungsmetadaten werden die Richtlinien "WCAG", die Richtlinie zur Barrierefreiheit von Webinhalten, und "ADA", "Americans with Disabilities Act Guidelines" verwendet. Weitere Informationen finden Sie auf der W3C-Website (World Wide Web Consortium).

Die verwendeten Prüfpunkte sind "1.1" und "1194.22(a)" für WCAG bzw. ADA, prüfpunkte, um sicherzustellen, dass ein Textäquivalent für Nicht-Text-Elemente vorhanden ist. Wird VerificationAttribute auf die ImageText -Eigenschaft angewendet, die die Textäquivalente einer anderen Eigenschaft namens ImagePropertydarstellt. Wenn die ImageText Eigenschaft nicht festgelegt ist, gibt die Barrierefreiheitsüberprüfung die Meldung "Dem Bild fehlt ein Textäquivalent" zurück.

[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

Hinweise

Eine Instanz der VerificationAttribute -Klasse definiert eine Barrierefreiheitsregel für Webinhalte, die überprüft werden kann. Weitere Informationen zu Richtlinien zur Barrierefreiheit von Webinhalten finden Sie auf der W3C-Website (World Wide Web Consortium).

Die minimale Menge an Informationen, die zum Definieren einer Instanz eines VerificationAttribute erforderlich sind, umfasst:

Eine Richtlinie, die die Überprüfungsregel darstellt. Der im -Konstruktor angegebene Wert legt die Guideline -Eigenschaft fest.
Ein Prüfpunkt der Richtlinie. Der im -Konstruktor angegebene Wert legt die Checkpoint -Eigenschaft fest.
Eine Prüfpunktpriorität. Der im -Konstruktor angegebene Wert legt die Priority -Eigenschaft fest.
Ein VerificationReportLevel Enumerationswert, der die Berichtsebene darstellt, zu der die Regel gehört. Der im -Konstruktor angegebene Wert legt die VerificationReportLevel -Eigenschaft fest.
Eine Meldung, die gemeldet wird, wenn die Überprüfungsregel true ist. Der im -Konstruktor angegebene Wert legt die Message -Eigenschaft fest.

Optionale Eigenschaften der Überprüfungsregel, die beim Erstellen einer Instanz angegeben werden können:

Ein VerificationRule Enumerationswert, der angibt, wie die Überprüfungsregel interpretiert werden soll. Der im -Konstruktor angegebene Wert legt die VerificationRule -Eigenschaft fest.
Ein VerificationConditionalOperator Enumerationswert, der den Operator im bedingten Ausdruck darstellt, der zum Testen der Überprüfungsregel verwendet wird. Der im -Konstruktor angegebene Wert legt die VerificationConditionalOperator -Eigenschaft fest.
Eine Barrierefreiheitsreferenz-URL. Der im -Konstruktor angegebene Wert legt die GuidelineUrl -Eigenschaft fest.
Ein bedingter Wert, der die rechte Seite eines bedingten Ausdrucks darstellt. Der im -Konstruktor angegebene Wert legt die ConditionalValue -Eigenschaft fest.
Eine bedingte Eigenschaft, die die linke Seite eines bedingten Ausdrucks darstellt. Der im -Konstruktor angegebene Wert legt die ConditionalProperty -Eigenschaft fest.

Die VerificationAttribute Metadaten können klassen-, Eigenschafts- und Indexerdeklarationen definiert werden.

Weitere Informationen zur Verwendung von Attributen finden Sie unter Attribute.

Konstruktoren

VerificationAttribute(String, String, VerificationReportLevel, Int32, String)	Initialisiert eine neue Instanz der VerificationAttribute-Klasse mit Barrierefreiheitsrichtlinie, Prüfpunkt, Berichterstellungsebene, Prüfpunktpriorität und Fehlermeldung.
VerificationAttribute(String, String, VerificationReportLevel, Int32, String, VerificationRule, String)	Initialisiert eine neue Instanz der VerificationAttribute-Klasse mit Barrierefreiheitsrichtlinie, Prüfpunkt, Berichterstellungsebene, Prüfpunktpriorität, Fehlermeldung, VerificationRule-Wert und zugehöriger bedingter Eigenschaft.
VerificationAttribute(String, String, VerificationReportLevel, Int32, String, VerificationRule, String, VerificationConditionalOperator, String, String)	Initialisiert eine neue Instanz der VerificationAttribute-Klasse mit Barrierefreiheitsrichtlinie, Prüfpunkt, Berichterstellungsebene, Prüfpunktpriorität, Fehlermeldung, VerificationRule-Wert, zugehöriger bedingter Eigenschaft, einem zugehörigen Wert einer bedingten Eigenschaft und einer URL zur Zugänglichkeitsreferenzrichtlinie.

Eigenschaften

Checkpoint	Ruft den Verweis auf den Barrierefreiheits-Prüfpunkt in der angegebenen Guideline-Eigenschaft ab.
ConditionalProperty	Ruft die linke Seite eines bedingten Ausdrucks ab, der für die Überprüfung von Barrierefreiheits-Prüfpunkten verwendet wird.
ConditionalValue	Ruft die rechte Seite eines bedingten Ausdrucks ab, der für die Überprüfung von Barrierefreiheits-Prüfpunkten verwendet wird.
Guideline	Ruft die Richtlinie ab, die für die Barrierefreiheitsüberprüfung verwendet wird.
GuidelineUrl	Ruft die in der Guideline-Eigenschaft angegebene URL ab, über die weitere Informationen über Barrierefreiheits-Richtlinien abgerufen werden können.
Message	Ruft eine Meldungszeichenfolge ab, wenn die Überprüfungsregel für den Barrierefreiheits-Prüfpunkt true ist.
Priority	Ruft die Priorität des Barrierefreiheits-Prüfpunkts ab.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)
VerificationConditionalOperator	Ruft einen VerificationConditionalOperator Enumerationswert ab, der angibt, wie der Barrierefreiheits-Prüfpunkt überprüft wird.
VerificationReportLevel	Ruft einen VerificationReportLevel Enumerationswert ab, der angibt, wie der Barrierefreiheits-Prüfpunkt verwendet wird.
VerificationRule	Ruft einen VerificationRule Enumerationswert ab, der angibt, wie der Barrierefreiheits-Prüfpunkt verwendet wird.

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Geerbt von Attribute)

Gilt für:

Weitere Informationen

Erweitern von Metadaten mithilfe von Attributen

Teilen über