Lista de atributos (Visual Basic)

Artigo
03/05/2024

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	Description
`attributemodifier`	Necessário para atributos aplicados no início de um arquivo de origem. Pode ser Montagem ou Módulo.
`attributename`	Obrigatório. Nome do atributo.
`attributearguments`	Opcional. Lista de argumentos posicionais para este atributo. Vários argumentos são separados por vírgulas.
`attributeinitializer`	Opcional. Lista de inicializadores de variável ou propriedade para este atributo. Vários inicializadores são separados por vírgulas.

Observações

Você pode aplicar um ou mais atributos a praticamente 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 o .NET Framework e pode definir seus próprios atributos.

Para obter mais informações sobre quando usar atributos, consulte Visão geral de atributos. Para obter informações sobre nomes de atributos, consulte Nomes de elementos declarados.

Regras

Colocação. Você pode aplicar atributos à maioria dos elementos de programação declarados. Para aplicar um ou mais atributos, coloque um bloco de atributos 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 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 um arquivo de origem. Os modificadores de atributos 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 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 biblioteca de vínculo dinâmico (DLL) não gerenciada. O atributo fornece o nome da DLL como um argumento posicional e as outras informações como inicializadores variáveis.

Partilhar via