Riferimenti e istruzione Imports (Visual Basic)

  • Articolo

È possibile rendere disponibili oggetti esterni al progetto scegliendo il comando Aggiungi riferimento dal menu Progetto. I riferimenti in Visual Basic possono puntare agli assembly, ad esempio librerie di tipi, ma contengono altre informazioni.

L'istruzione Imports

Gli assembly includono uno o più spazi dei nomi. Quando si aggiunge un riferimento a un assembly, è anche possibile aggiungere un'istruzione Imports a un modulo che controlla la visibilità degli spazi dei nomi dell'assembly all'interno del modulo. L'istruzione Imports fornisce un contesto di ambito che consente di usare solo la parte dello spazio dei nomi necessaria per fornire un riferimento univoco.

L'istruzione Imports presenta la sintassi seguenti:

Imports [Aliasname =] Namespace

Aliasname fa riferimento a un nome breve che è possibile usare all'interno del codice per fare riferimento a uno spazio dei nomi importato. Namespace è uno spazio dei nomi disponibile tramite un riferimento al progetto, tramite una definizione all'interno del progetto o tramite un'istruzione Imports precedente.

Un modulo può contenere un numero qualsiasi di istruzioni Imports. Devono essere visualizzati dopo qualsiasi istruzione Option, se presente, ma prima di qualsiasi altro codice.

Nota

Non confondere i riferimenti di progetto con l'istruzione Imports o l'istruzione Declare. I riferimenti al progetto rendono disponibili oggetti esterni, ad esempio gli oggetti negli assembly, per i progetti Visual Basic. L'istruzione Imports viene usata per semplificare l'accesso ai riferimenti al progetto, ma non fornisce l'accesso a questi oggetti. L'istruzione Declare viene usata per dichiarare un riferimento a una routine esterna in una libreria a collegamento dinamico (DLL).

Uso di alias con l'istruzione Imports

L'istruzione Imports semplifica l'accesso ai metodi delle classi eliminando la necessità di digitare in modo esplicito i nomi completi dei riferimenti. Gli alias consentono di assegnare un nome più descrittivo a una sola parte di uno spazio dei nomi. Ad esempio, la sequenza di ritorno a capo/avanzamento riga che determina la visualizzazione di una singola parte di testo su più righe fa parte del modulo ControlChars nello spazio dei nomi Microsoft.VisualBasic. Per usare questa costante in un programma senza alias, è necessario digitare il codice seguente:

MsgBox("Some text" & Microsoft.VisualBasic.ControlChars.CrLf &
       "Some more text")

Le istruzioni Imports devono essere sempre le prime righe immediatamente successive a qualsiasi istruzione Option in un modulo. Il frammento di codice seguente illustra come importare e assegnare un alias al modulo Microsoft.VisualBasic.ControlChars:

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

I riferimenti futuri a questo spazio dei nomi potranno essere notevolmente più brevi:

MsgBox("Some text" & CtrlChrs.CrLf & "Some more text")

Se un'istruzione Imports non include un nome alias, gli elementi definiti all'interno dello spazio dei nomi importato possono essere usati nel modulo senza qualifica. Se viene specificato il nome dell'alias, deve essere usato come qualificatore per i nomi contenuti all'interno di tale spazio dei nomi.

Vedi anche