VerificationAttribute Класс

Ссылка

Определение

Пространство имен:: System.Web.UI

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Определяет атрибут метаданных правила доступа к веб-содержимому. Этот класс не наследуется.

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, руководство по специальным возможностям веб-содержимого и "ADA", американцы с ограниченными возможностями. Дополнительные сведения см. на веб-сайте консорциума W3C.

Используемые контрольные точки : "1.1" и "1194.22(a)" для 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 веб-содержимого, которое можно проверить. Дополнительные сведения о рекомендациях по специальным возможностям веб-содержимого см. на веб-сайте консорциума 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 с правилом доступности, контрольной точкой, уровнем отчета, приоритетом контрольной точки, сообщением об ошибке, значением VerificationRule и соответствующим условным свойством.
VerificationAttribute(String, String, VerificationReportLevel, Int32, String, VerificationRule, String, VerificationConditionalOperator, String, String)	Инициализирует новый экземпляр класса VerificationAttribute с правилом доступности, контрольной точкой, уровнем отчета, приоритетом контрольной точки, сообщением об ошибке, значением VerificationRule, соответствующим условным свойством, соответствующим значением условного свойства и ссылкой на URL-адрес правила.

Свойства

Checkpoint	Возвращает ссылку на контрольную точку доступа в указанном свойстве Guideline.
ConditionalProperty	Возвращает левую сторону условного выражения, используемую как часть контрольной точки проверки доступа.
ConditionalValue	Возвращает правую сторону условного выражения, используемую как часть контрольной точки проверки доступа.
Guideline	Возвращает правило, используемое для проверки доступа.
GuidelineUrl	Возвращает URL-адрес, который можно использовать для получения дополнительной информации по правилам доступа, заданным в свойстве Guideline.
Message	Возвращает сообщение, если правило проверки контрольной точки доступа верное.
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)	Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации. (Унаследовано от Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса. (Унаследовано от Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1). (Унаследовано от Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Предоставляет доступ к открытым свойствам и методам объекта. (Унаследовано от Attribute)

Применяется к

См. также раздел

Расширение метаданных с помощью атрибутов