Elenco degli attributi (Visual Basic)

Articolo
08/11/2011

Specifica gli attributi da applicare a un elemento di programmazione dichiarato. Gli attributi sono separati da una virgola. Di seguito è riportata la sintassi per un attributo unico.

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

Parti

attributemodifier
Obbligatoria per gli attributi applicati all'inizio di un file di origine. Può essere Assembly (Visual Basic) o Modulo.
attributename
Obbligatoria. Nome dell'attributo.
attributearguments
Facoltativo. Elenco degli argomenti posizionali per l'attributo. Gli argomenti sono separati da una virgola.
attributeinitializer
Facoltativo. Elenco di inizializzatori di proprietà o variabili per l'attributo. Gli inizializzatori sono separati da una virgola.

Note

È possibile applicare uno o più attributi a quasi tutti gli elementi di programmazione (tipi, routine, proprietà e così via). Gli attributi vengono visualizzati nei metadati dell'assembly e consentono di apporre annotazioni al codice o di specificare le modalità di utilizzo di un elemento di programmazione specifico. È possibile applicare attributi definiti da Visual Basic e .NET Framework oppure definire attributi personalizzati.

Per ulteriori informazioni sull'utilizzo degli attributi, vedere Attributi (C# e Visual Basic). Per informazioni sui nomi degli attributi, vedere Nomi di elementi dichiarati (Visual Basic).

Regole

Posizionamento. Gli attributi possono essere applicati alla maggior parte degli elementi di programmazione dichiarati. Per applicare uno o più attributi, posizionare un blocco di attributi all'inizio della dichiarazione dell'elemento. Ciascuna voce dell'elenco di attributi specifica un attributo che si desidera applicare, nonché il modificatore e gli argomenti utilizzati per la chiamata dell'attributo.
Parentesi angolari. Quando si specifica un elenco di attributi, è necessario racchiuderlo tra parentesi acute ("<" e ">").
Parte della dichiarazione. L'attributo deve far parte della dichiarazione dell'elemento, non deve costituire un'istruzione separata. È possibile utilizzare la sequenza di continuazione di riga (" _") per estendere l'istruzione di dichiarazione a righe di codice sorgente multiple.
Modificatori. Per ciascun attributo che viene applicato a un elemento di programmazione all'inizio di un file di origine è necessario un modificatore di attributo (Assembly o Module). L'utilizzo dei modificatori di attributo non è consentito per gli attributi applicati a elementi che non si trovano all'inizio di un file di origine.
Argomenti. Tutti gli argomenti posizionali relativi a un attributo devono precedere eventuali inizializzatori di proprietà o variabili.

Esempio

Nell'esempio riportato di seguito l'attributo DllImportAttribute viene applicato a una definizione di base di una routine 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 che la routine con attributi rappresenta un punto di ingresso di una libreria a collegamento dinamico (DLL) non gestita. L'attributo fornisce il nome della DLL come argomento posizionale e altre informazioni quali gli inizializzatori delle variabili.