Lista de atributos

Especifica os atributos a serem aplicados a um elemento de programação declarado.Diversos parâmetros são separados por vírgulas.A seguir está a sintaxe para um atributo.

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

Partes

  • attributemodifier
    Necessário para os atributos aplicados no início de uma arquivo fonte.Pode ser Assembly ou Módulo.

  • attributename
    Obrigatório.Nome do atributo.

  • attributearguments
    Opcional.Lista de argumentos posicionais para este atributo.Múltiplos argumentos são separados por vírgulas.

  • attributeinitializer
    Opcional.Lista de variáveis ou propriedades inicializadoras para este atributo.Inicializadores múltiplos são separados por vírgulas.

Comentários

Você pode aplicar um ou mais atributos para praticamente qualquer elemento de programação (tipos, procedimentos, propriedades e etc).Atributos aparecem nos metadados do seu assembly, e eles podem ajudar você anotar o código ou especificar como deseja usar um determinado elemento de programação.Você pode aplicar os atributos definidos pelo Visual Basic e Framework .NET, e você pode definir seus próprios atributos.

Para obter mais informações sobre quando usar atributos, consulte Atributos no Visual Basic e Usos comuns para atributos.Para obter informações sobre nomes de atributo, consulte Nomes de Elementos Declarados.

Regras

  • Posicionamento. Você pode aplicar atributos para a maioria dos elementos de programação declarados.Para aplicar um ou mais atributos, você insere um bloco de atributo no início da declaração do elemento.Cada entrada na lista de atributos especifica um atributo que deseja aplicar, e o modificador e argumentos que você está usando para esta chamada do atributo.

  • Colchetes. Se você fornecer uma lista de atributos, você deve colocá-la entre colchetes("<"e ">").

  • Parte da declaração. O atributo deve ser parte da declaração do elemento, não uma instrução separada.Você pode utilizar uma sequência de continuação de linha (" _") para estender a instrução de declaração em várias linhas de código-fonte.

  • Modificadores Um modificador de atributo (Assembly ou Module) é necessário em cada atributo aplicado a um elemento de programação no início de uma arquivo fonte.Modificadores de atributo não são permitidos em atributos aplicados aos elementos que não estão no início de um arquivo fonte.

  • Argumentos Todos os argumentos posicionais para um atributo devem preceder qualquer variável ou inicializadores de propriedade .

Exemplo

O exemplo seguinte aplica o atributo DllImportAttribute à definição reduzida de um procedimento Function.

<DllImportAttribute("kernel32.dll", EntryPoint:="MoveFileW", _
    SetLastError:=True, CharSet:=CharSet.Unicode, _
    ExactSpelling:=True, _
    CallingConvention:=CallingConvention.StdCall)> _
Public Shared Function moveFile(ByVal src As String, _
  ByVal dst As String) As Boolean
    ' This function copies a file from the path src to the path dst.
    ' Leave this function empty. The DLLImport attribute forces calls
    ' to moveFile to be forwarded to MoveFileW in KERNEL32.DLL.
End Function

DllImportAttribute indica que o procedimento atribuído representa um ponto de entrada em uma biblioteca Dynamic-link não gerenciada (DLL).O atributo fornece o nome da DLL como um argumento posicional e as outras informações como inicializadores de variável .

Consulte também

Tarefas

Como: Quebrar e combinar instruções no código

Conceitos

Usos comuns para atributos

Aplicação de Atributos

Referência

Assembly

Módulo (Visual Basic)

Outros recursos

Atributos no Visual Basic