VerificationAttribute Класс

Определение

Определяет атрибут метаданных правила доступа к веб-содержимому.Defines the metadata attribute of a Web content accessibility rule. Этот класс не наследуется.This class cannot be inherited.

public ref class VerificationAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Property, AllowMultiple=true)]
public sealed class VerificationAttribute : Attribute
type VerificationAttribute = class
    inherit Attribute
Public NotInheritable Class VerificationAttribute
Inherits Attribute
Наследование
VerificationAttribute
Атрибуты

Примеры

В следующем примере кода показано использование VerificationAttribute класса.The following code example demonstrates using the VerificationAttribute class. В определении метаданных проверки используются рекомендации "WCAG", "рекомендации по специальным возможностям веб-содержимого" и "ADA", американцев с ограниченными правилами.In the verification metadata definition, the guidelines used are "WCAG," the Web Content Accessibility Guideline, and "ADA," Americans with Disabilities Act Guidelines. Дополнительные сведения см. на веб-сайте консорциум W3C (W3C).For more information, see the World Wide Web Consortium (W3C) Web site.

В качестве контрольных точек используются "1,1" и "1194.22 (a)" для WCAG и ADA соответственно, контрольные точки для обеспечения существования текстового эквивалента для нетекстовых элементов.The checkpoints used are "1.1" and "1194.22(a)" for WCAG and ADA, respectively, checkpoints for ensuring that a text equivalent exists for non-text elements. Атрибут применяется к свойству, представляющему текст, эквивалентный другому свойству ImagePropertyс именем. ImageText VerificationAttributeThe VerificationAttribute is applied to the ImageText property that represents the text equivalent of another property called ImageProperty. ImageText Если свойство не задано, то проверка специальных возможностей возвратит сообщение "в образе отсутствует текстовый эквивалент".If the ImageText property is not set, the accessibility verification will return the message "The image is missing a text equivalent."

[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 класса определяет правило доступности веб-содержимого, которое можно проверить.An instance of the VerificationAttribute class defines a Web content accessibility rule that can be verified. Дополнительные сведения о рекомендациях по обеспечению доступности веб-содержимого см. на веб-сайте консорциум W3C (W3C).For more information on Web Content Accessibility Guidelines, see the World Wide Web Consortium (W3C) Web site.

Минимальный объем информации, необходимой для определения экземпляра, VerificationAttribute включает:The minimal amount of information required to define an instance of a VerificationAttribute includes:

  • Рекомендация, которую представляет правило проверки.A guideline that the verification rule represents. Значение, указанное в конструкторе, задает Guideline свойство.The value specified in the constructor sets the Guideline property.

  • Контрольная точка рекомендации.A checkpoint of the guideline. Значение, указанное в конструкторе, задает Checkpoint свойство.The value specified in the constructor sets the Checkpoint property.

  • Приоритет контрольной точки.A checkpoint priority. Значение, указанное в конструкторе, задает Priority свойство.The value specified in the constructor sets the Priority property.

  • Значение VerificationReportLevel перечисления, представляющее уровень отчетов, к которому относится правило.A VerificationReportLevel enumeration value that represents the reporting level that should be rule belongs to. Значение, указанное в конструкторе, задает VerificationReportLevel свойство.The value specified in the constructor sets the VerificationReportLevel property.

  • Сообщение, о котором сообщается, когда правило проверки имеет значение true.A message that is reported when the verification rule is true. Значение, указанное в конструкторе, задает Message свойство.The value specified in the constructor sets the Message property.

Необязательные свойства правила проверки, которые могут быть указаны при создании экземпляра:Optional properties of the verification rule that can be specified when creating an instance:

  • Значение VerificationRule перечисления, представляющее способ интерпретации правила проверки.A VerificationRule enumeration value that represents how the verification rule should be interpreted. Значение, указанное в конструкторе, задает VerificationRule свойство.The value specified in the constructor sets the VerificationRule property.

  • Значение VerificationConditionalOperator перечисления, представляющее оператор в условном выражении, используемый для проверки правила проверки.A VerificationConditionalOperator enumeration value that represents the operator in the conditional expression used to test the verification rule. Значение, указанное в конструкторе, задает VerificationConditionalOperator свойство.The value specified in the constructor sets the VerificationConditionalOperator property.

  • URL-адрес рекомендации по специальным возможностям.An accessibility reference guideline URL. Значение, указанное в конструкторе, задает GuidelineUrl свойство.The value specified in the constructor sets the GuidelineUrl property.

  • Условное значение, представляющее правую часть условного выражения.A conditional value representing the right side of a conditional expression. Значение, указанное в конструкторе, задает ConditionalValue свойство.The value specified in the constructor sets the ConditionalValue property.

  • Условное свойство, представляющее левую сторону условного выражения.A conditional property representing the left side of a conditional expression. Значение, указанное в конструкторе, задает ConditionalProperty свойство.The value specified in the constructor sets the ConditionalProperty property.

Метаданные VerificationAttribute могут быть определены в объявлениях классов, свойств и индексаторов.The VerificationAttribute metadata can be defined class, property, and indexer declarations.

Дополнительные сведения об использовании атрибутов см. в разделе атрибуты.For more information about using attributes, see Attributes.

Конструкторы

VerificationAttribute(String, String, VerificationReportLevel, Int32, String)

Инициализирует новый экземпляр класса VerificationAttribute с правилом доступности, контрольной точкой, уровнем отчета, приоритетом контрольной точки и сообщением об ошибке.Initializes a new instance of the VerificationAttribute class with accessibility guideline, checkpoint, reporting level, checkpoint priority, and error message.

VerificationAttribute(String, String, VerificationReportLevel, Int32, String, VerificationRule, String)

Инициализирует новый экземпляр класса VerificationAttribute с правилом доступности, контрольной точкой, уровнем отчета, приоритетом контрольной точки, сообщением об ошибке, значением VerificationRule и соответствующим условным свойством.Initializes a new instance of the VerificationAttribute class with accessibility guideline, checkpoint, reporting level, checkpoint priority, error message, VerificationRule.value, and related conditional property.

VerificationAttribute(String, String, VerificationReportLevel, Int32, String, VerificationRule, String, VerificationConditionalOperator, String, String)

Инициализирует новый экземпляр класса VerificationAttribute с правилом доступности, контрольной точкой, уровнем отчета, приоритетом контрольной точки, сообщением об ошибке, значением VerificationRule, соответствующим условным свойством, соответствующим значением условного свойства и ссылкой на URL-адрес правила.Initializes a new instance of the VerificationAttribute class with accessibility guideline, checkpoint, reporting level, checkpoint priority, error message, VerificationRule.value, related conditional property, a related conditional property value, and a reference guideline URL.

Свойства

Checkpoint

Возвращает ссылку на контрольную точку доступа в указанном свойстве Guideline.Gets the accessibility checkpoint reference in the specified Guideline property.

ConditionalProperty

Возвращает левую сторону условного выражения, используемую как часть контрольной точки проверки доступа.Gets the left side of a conditional expression used as part of the verification accessibility checkpoint.

ConditionalValue

Возвращает правую сторону условного выражения, используемую как часть контрольной точки проверки доступа.Gets the right side of a conditional expression used as part of the verification accessibility checkpoint.

Guideline

Возвращает правило, используемое для проверки доступа.Gets the guideline that used for accessibility checking.

GuidelineUrl

Возвращает URL-адрес, который можно использовать для получения дополнительной информации по правилам доступа, заданным в свойстве Guideline.Gets the URL the can be used to get more information on the accessibility guidelines given in the Guideline property.

Message

Возвращает сообщение, если правило проверки контрольной точки доступа верное.Gets a message string when the accessibility checkpoint verification rule is true.

Priority

Возвращает приоритет контрольной точки доступа.Gets the priority of the accessibility checkpoint.

TypeId

При реализации в производном классе возвращает уникальный идентификатор для этого Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Унаследовано от Attribute)
VerificationConditionalOperator

Возвращает определение значения перечисления VerificationConditionalOperator о проверке контрольной точки доступа.Gets a VerificationConditionalOperator enumeration value indication how the accessibility checkpoint is verified.

VerificationReportLevel

Возвращает определение значения перечисления VerificationReportLevel об использовании контрольной точки доступа.Gets a VerificationReportLevel enumeration value indicating how the accessibility checkpoint is used.

VerificationRule

Возвращает определение значения перечисления VerificationRule об использовании контрольной точки доступа.Gets a VerificationRule enumeration value indicating how the accessibility checkpoint is used.

Методы

Equals(Object)

Возвращает значение, показывающее, равен ли экземпляр указанному объекту.Returns a value that indicates whether this instance is equal to a specified object.

(Унаследовано от Attribute)
GetHashCode()

Возвращает хэш-код данного экземпляра.Returns the hash code for this instance.

(Унаследовано от Attribute)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
IsDefaultAttribute()

При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Унаследовано от Attribute)
Match(Object)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Унаследовано от Attribute)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Явные реализации интерфейса

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.Maps a set of names to a corresponding set of dispatch identifiers.

(Унаследовано от Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Унаследовано от Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Унаследовано от Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.Provides access to properties and methods exposed by an object.

(Унаследовано от Attribute)

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

Дополнительно