Elenco degli attributi (Visual Basic)

Articolo
04/02/2024

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.

Sintassi

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

Parti

In parte	Descrizione
`attributemodifier`	Obbligatorio per gli attributi applicati all'inizio di un file di origine. Può essere Assembly o Modulo.
`attributename`	Obbligatorio. Nome dell'attributo.
`attributearguments`	Facoltativo. Elenco di argomenti posizionali per questo attributo. Più argomenti sono separati da virgole.
`attributeinitializer`	Facoltativo. Elenco di inizializzatori di variabili o proprietà per questo attributo. Più inizializzatori sono separati da virgole.

Osservazioni:

È possibile applicare uno o più attributi a quasi qualsiasi elemento di programmazione (tipi, procedure, proprietà e così via). Gli attributi vengono visualizzati nei metadati dell'assembly e consentono di annotare il codice o specificare come usare un particolare elemento di programmazione. È possibile applicare attributi definiti da Visual Basic e .NET Framework ed è possibile definire attributi personalizzati.

Per altre informazioni su quando usare gli attributi, vedere Panoramica sugli attributi. Per informazioni sui nomi degli attributi, vedere Nomi di elementi dichiarati.

Regole

Posizionamento. È possibile applicare attributi alla maggior parte degli elementi di programmazione dichiarati. Per applicare uno o più attributi, inserire un blocco di attributi all'inizio della dichiarazione dell'elemento. Ogni voce nell'elenco di attributi specifica un attributo da applicare e il modificatore e gli argomenti usati per questa chiamata dell'attributo.
Parentesi angolari. Se si specifica un elenco di attributi, è necessario racchiuderlo tra parentesi angolari ("<" e ">").
Parte della dichiarazione. L'attributo deve far parte della dichiarazione dell'elemento, non di un'istruzione separata. È possibile usare la sequenza di continuazione riga ("_") per estendere l'istruzione di dichiarazione su più righe di codice sorgente.
Modificatori. Un modificatore di attributo (Assembly o Module) è obbligatorio per ogni attributo applicato a un elemento di programmazione all'inizio di un file di origine. I modificatori di attributi non sono consentiti sugli attributi applicati agli elementi che non si trovano all'inizio di un file di origine.
Argomenti. Tutti gli argomenti posizionali per un attributo devono precedere qualsiasi inizializzatore di variabili o proprietà.

Esempio

Nell'esempio seguente l'attributo DllImportAttribute viene applicato a una definizione di struttura 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 in una libreria di collegamento dinamico (DLL) non gestita. L'attributo fornisce il nome della DLL come argomento posizionale e le altre informazioni come inizializzatori di variabili.

Condividi tramite