VerificationAttribute Classe

Referência

Definição

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Define o atributo de metadados de uma regra de acessibilidade de conteúdo da Web. Essa classe não pode ser herdada.

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

Herança: Object

Attribute
VerificationAttribute

Atributos: AttributeUsageAttribute

Exemplos

O exemplo de código a seguir demonstra o uso da VerificationAttribute classe. Na definição de metadados de verificação, as diretrizes usadas são "WCAG", a Diretriz de Acessibilidade de Conteúdo da Web e "ADA", diretrizes da Lei dos Americanos com Deficiências. Para obter mais informações, consulte o site do W3C (World Wide Web Consortium).

Os pontos de verificação usados são "1.1" e "1194.22(a)" para WCAG e ADA, respectivamente, pontos de verificação para garantir que exista um equivalente de texto para elementos não textuais. O VerificationAttribute valor é aplicado à ImageText propriedade que representa o equivalente de texto de outra propriedade chamada ImageProperty. Se a ImageText propriedade não estiver definida, a verificação de acessibilidade retornará a mensagem "A imagem está faltando um equivalente de texto".

[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

Comentários

Uma instância da VerificationAttribute classe define uma regra de acessibilidade de conteúdo da Web que pode ser verificada. Para obter mais informações sobre diretrizes de acessibilidade de conteúdo da Web, consulte o site W3C (World Wide Web Consortium).

A quantidade mínima de informações necessárias para definir uma instância de um VerificationAttribute inclui:

Uma diretriz que a regra de verificação representa. O valor especificado no construtor define a Guideline propriedade.
Um ponto de verificação da diretriz. O valor especificado no construtor define a Checkpoint propriedade.
Uma prioridade de ponto de verificação. O valor especificado no construtor define a Priority propriedade.
Um VerificationReportLevel valor de enumeração que representa o nível de relatório ao qual a regra deve pertencer. O valor especificado no construtor define a VerificationReportLevel propriedade.
Uma mensagem que é relatada quando a regra de verificação é verdadeira. O valor especificado no construtor define a Message propriedade.

Propriedades opcionais da regra de verificação que podem ser especificadas ao criar uma instância:

Um VerificationRule valor de enumeração que representa como a regra de verificação deve ser interpretada. O valor especificado no construtor define a VerificationRule propriedade.
Um VerificationConditionalOperator valor de enumeração que representa o operador na expressão condicional usada para testar a regra de verificação. O valor especificado no construtor define a VerificationConditionalOperator propriedade.
Uma URL de diretriz de referência de acessibilidade. O valor especificado no construtor define a GuidelineUrl propriedade.
Um valor condicional que representa o lado direito de uma expressão condicional. O valor especificado no construtor define a ConditionalValue propriedade.
Uma propriedade condicional que representa o lado esquerdo de uma expressão condicional. O valor especificado no construtor define a ConditionalProperty propriedade.

Os VerificationAttribute metadados podem ser declarações de classe, propriedade e indexador definidas.

Para obter mais informações sobre como usar atributos, consulte Atributos.

Construtores

VerificationAttribute(String, String, VerificationReportLevel, Int32, String)	Inicializa uma nova instância da classe VerificationAttribute com as diretrizes de acessibilidade, o ponto de verificação, o nível de relatório, a prioridade de ponto de verificação e a mensagem de erro.
VerificationAttribute(String, String, VerificationReportLevel, Int32, String, VerificationRule, String)	Inicializa uma nova instância da classe VerificationAttribute com a diretriz de acessibilidade, o ponto de verificação, o nível do relatório, a prioridade de ponto de verificação, a mensagem de erro, VerificationRule.value e a propriedade condicional relacionada.
VerificationAttribute(String, String, VerificationReportLevel, Int32, String, VerificationRule, String, VerificationConditionalOperator, String, String)	Inicializa uma nova instância da classe VerificationAttribute com a diretriz de acessibilidade, o ponto de verificação, o nível do relatório, a prioridade de ponto de verificação, a mensagem de erro, VerificationRule.value, a propriedade condicional relacionada, um valor da propriedade condicional relacionada e uma URL de referência à diretriz.

Propriedades

Checkpoint	Obtém a referência do ponto de verificação de acessibilidade na propriedade Guideline especificada.
ConditionalProperty	Obtém o lado esquerdo de uma expressão condicional usado como parte da verificação do ponto de verificação de acessibilidade.
ConditionalValue	Obtém o lado direito de uma expressão condicional usado como parte da verificação do ponto de verificação de acessibilidade.
Guideline	Obtém a diretriz usada para a verificação de acessibilidade.
GuidelineUrl	Obtém a URL que pode ser usada para obter mais informações sobre as diretrizes de acessibilidade fornecidas na propriedade Guideline.
Message	Obtém uma cadeia de caracteres de mensagem quando a regra de verificação do ponto de verificação de acessibilidade é true.
Priority	Obtém a prioridade do ponto de verificação de acessibilidade.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)
VerificationConditionalOperator	Obtém um valor de enumeração VerificationConditionalOperator que indica como o ponto de verificação de acessibilidade é verificado.
VerificationReportLevel	Obtém um valor de enumeração VerificationReportLevel que indica como o ponto de verificação de acessibilidade é usado.
VerificationRule	Obtém um valor de enumeração VerificationRule que indica como o ponto de verificação de acessibilidade é usado.

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição. (Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera as informações de tipo para um objeto, que pode ser usado para obter as informações de tipo para uma interface. (Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1). (Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornece acesso a propriedades e métodos expostos por um objeto. (Herdado de Attribute)

Aplica-se a

Confira também

Estendendo metadados por meio de atributos

Partilhar via