VerificationAttribute Classe

Definição

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 seguinte demonstra o uso da VerificationAttribute classe. Na definição de metadados de verificação, as diretrizes utilizadas são "WCAG", a Web Content Accessibility Guideline, e "ADA", Americans with Disabilities Act Guidelines. Para mais informações, consulte o site do World Wide Web Consortium (W3C).

Os pontos de controlo utilizados são "1.1" e "1194.22(a)" para WCAG e ADA, respetivamente, pontos de controlo para garantir que existe um equivalente textual para elementos não textuais. A VerificationAttribute é aplicada à ImageText propriedade que representa o equivalente textual de outra propriedade chamada ImageProperty. Se a ImageText propriedade não estiver definida, a verificação de acessibilidade devolverá a mensagem "A imagem está em falta de 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

Observações

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

A quantidade mínima de informação necessária para definir uma instância de um VerificationAttribute inclui:

• Uma orientação que a regra de verificação representa. O valor especificado no construtor define a Guideline propriedade.

• Um ponto de controlo da diretriz. O valor especificado no construtor define a Checkpoint propriedade.

• Prioridade no posto de controlo. O valor especificado no construtor define a Priority propriedade.

• Um valor de enumeração que representa o nível de reporte a que deve pertencer a VerificationReportLevel regra. O valor especificado no construtor define a VerificationReportLevel propriedade.

• Uma mensagem que é reportada 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 referência 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 definidos como declarações de classe, propriedade e indexador.

Para mais informações sobre o uso de atributos, consulte Atributos.

Ver também

• Extensão dos Metadados Usando Atributos