Lista de atributos (Visual Basic)

  • Artigo

Especifica os atributos a serem aplicados a um elemento de programação declarado. Vários atributos são separados por vírgulas. A seguir está a sintaxe de um atributo.

Sintaxe

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

Partes

Parte Descrição
attributemodifier Necessário para atributos aplicados no início de um arquivo de origem. Pode ser Assembly ou Módulo.
attributename Obrigatórios. Nome do atributo.
attributearguments Opcional. Lista de argumentos posicionais para esse atributo. Vários argumentos são separados por vírgulas.
attributeinitializer Opcional. Lista de inicializadores de propriedades ou variáveis para esse atributo. Vários inicializadores são separados por vírgulas.

Comentários

Você pode aplicar um ou mais atributos a quase qualquer elemento de programação (tipos, procedimentos, propriedades e assim por diante). Os atributos aparecem nos metadados do assembly e podem ajudar você a anotar o código ou especificar como usar um determinado elemento de programação. Você pode aplicar atributos definidos pelo Visual Basic e pelo .NET Framework e pode definir os próprios atributos.

Para obter mais informações sobre quando usar atributos, confira a visão geral de Atributos. Para obter informações sobre nomes de atributos, confira Nomes de Elementos Declarados.

Regras

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

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

  • Parte da Declaração. O atributo deve fazer parte da declaração do elemento, não uma instrução separada. Você pode usar a sequência de continuação de linha (" _") para estender a instrução de declaração para 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 um arquivo de origem. Modificadores de atributo não são permitidos em atributos aplicados a elementos que não estão no início de um arquivo de origem.

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

Exemplo

O exemplo a seguir aplica o atributo DllImportAttribute a uma definição de esqueleto 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 BBL (biblioteca de vínculo dinâmico) não gerenciada. O atributo fornece o nome da DLL como um argumento posicional e as outras informações como inicializadores de variáveis.

Confira também