Condividi tramite


Elenco degli attributi (Visual Basic)

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.

Vedere anche

Attività

Procedura: interrompere e combinare istruzioni nel codice (Visual Basic)

Riferimenti

Assembly (Visual Basic)

Modulo <parola chiave> (Visual Basic)

Attributi (C# e Visual Basic)