Compartilhar via

Lista de atributos (Visual Basic)

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ório 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.

Observações

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 ajudá-lo a anotar seu código ou especificar como usar um elemento de programação específico. Você pode aplicar atributos definidos pelo Visual Basic e pelo .NET Framework e pode definir seus próprios atributos.

Para obter mais informações sobre quando usar atributos, consulte a visão geral de atributos. Para obter informações sobre nomes de atributo, consulte 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 de 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.

  • Parênteses 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 de 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 de um atributo devem preceder qualquer variável ou inicializador de propriedade.

Exemplo

O exemplo a seguir aplica o DllImportAttribute atributo a uma definição de esqueleto de um Function procedimento.

<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 DLL (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ável.

Consulte também

  • Last updated on