Lista de atributos (Visual Basic)

Artigo
02/25/2013

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 (Visual Basic) 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 os atributos, consulte Atributos (C# e Visual Basic).Para obter informações sobre nomes de atributo, consulte Nomes de elementos declarados (Visual Basic).

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, deve colocar colchetes angulares ("<"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.
Modificador. Um modificador de atributo (Assembly ou Module) é necessária em todos os atributos aplicados 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 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 .