VerificationAttribute 類別

參考

定義

命名空間:: System.Web.UI

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

定義無障礙網頁開發規則的中繼資料屬性。此類別無法獲得繼承。

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

繼承: Object

Attribute
VerificationAttribute

屬性: AttributeUsageAttribute

範例

下列程式碼範例示範如何使用 VerificationAttribute 類別。在驗證元資料定義中，使用的指導方針是「WCAG」、Web 內容協助工具指導方針，以及「ADA」，美國殘障人士法案指導方針。如需詳細資訊，請參閱 World Wide Web Consortium (W3C) 網站。

使用的檢查點分別是「1.1」和「1194.22 (WCAG 和 ADA 的) 」，分別用於確保非文字元素的文字對等專案存在。 VerificationAttribute會套用至 ImageText 屬性，代表另一個稱為 ImageProperty 的文字對等專案。 ImageText如果未設定屬性，協助工具驗證會傳回訊息「影像遺漏對等文字」。

[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

備註

類別的 VerificationAttribute 實例會定義可驗證的 Web 內容協助工具規則。如需 Web 內容協助工具指導方針的詳細資訊，請參閱 World Wide Web Consortium (W3C) 網站。

定義實例 VerificationAttribute 所需的最小資訊量包括：

驗證規則所代表的指導方針。建構函式中指定的值會設定 Guideline 屬性。
指導方針的檢查點。建構函式中指定的值會設定 Checkpoint 屬性。
檢查點優先順序。建構函式中指定的值會設定 Priority 屬性。
VerificationReportLevel列舉值，表示應為規則所屬的報告層級。建構函式中指定的值會設定 VerificationReportLevel 屬性。
驗證規則為 true 時所報告的訊息。建構函式中指定的值會設定 Message 屬性。

建立實例時可指定之驗證規則的選擇性屬性：

VerificationRule列舉值，表示驗證規則的解譯方式。建構函式中指定的值會設定 VerificationRule 屬性。
VerificationConditionalOperator列舉值，表示用來測試驗證規則的條件運算式中的運算子。建構函式中指定的值會設定 VerificationConditionalOperator 屬性。
協助工具參考指導方針 URL。建構函式中指定的值會設定 GuidelineUrl 屬性。
條件式值，表示條件運算式右側。建構函式中指定的值會設定 ConditionalValue 屬性。
表示條件運算式左邊的條件屬性。建構函式中指定的值會設定 ConditionalProperty 屬性。

VerificationAttribute中繼資料可以定義類別、屬性和索引子宣告。

如需使用屬性的詳細資訊，請參閱屬性。

建構函式

VerificationAttribute(String, String, VerificationReportLevel, Int32, String)	使用協助工具方針、檢查點、報告層級、檢查點優先權，以及錯誤訊息，初始化 VerificationAttribute 類別的新執行個體。
VerificationAttribute(String, String, VerificationReportLevel, Int32, String, VerificationRule, String)	使用協助工具方針、檢查點、報告層級、檢查點優先權、錯誤訊息、VerificationAttribute.value，以及相關條件屬性，初始化 VerificationRule 類別的新執行個體。
VerificationAttribute(String, String, VerificationReportLevel, Int32, String, VerificationRule, String, VerificationConditionalOperator, String, String)	使用協助工具方針、檢查點、報告層級、檢查點優先權、錯誤訊息、VerificationAttribute.value、相關條件屬性、相關條件屬性值，以及參考方針 URL，初始化 VerificationRule 類別的新執行個體。

屬性

Checkpoint	取得指定之 Guideline 屬性中的協助工具檢查點參考。
ConditionalProperty	取得條件運算式的左邊，用做驗證協助工具檢查點的一部分。
ConditionalValue	取得條件運算式的右邊，用做驗證協助工具檢查點的一部分。
Guideline	取得用於檢查協助工具的方針。
GuidelineUrl	取得 URL，可以用來取得 Guideline 屬性中指定之協助工具方針的詳細資訊。
Message	當協助工具檢查點驗證規則為 true 時取得訊息字串。
Priority	取得協助工具檢查點的優先權。
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)
VerificationConditionalOperator	取得 VerificationConditionalOperator 列舉值，表示協助工具檢查點的驗證方式。
VerificationReportLevel	取得 VerificationReportLevel 列舉值，表示協助工具檢查點的使用方式。
VerificationRule	取得 VerificationRule 列舉值，表示協助工具檢查點的使用方式。

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承來源 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	擷取物件的類型資訊，可以用來取得介面的類型資訊。 (繼承來源 Attribute)
_Attribute.GetTypeInfoCount(UInt32)	擷取物件提供的類型資訊介面數目 (0 或 1)。 (繼承來源 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	提供物件所公開的屬性和方法的存取權。 (繼承來源 Attribute)

適用於

另請參閱

使用屬性擴充中繼資料

共用方式為

VerificationAttribute 類別

定義

範例

備註

建構函式

屬性

方法

明確介面實作

適用於

另請參閱

其他資源