Condividi tramite

Riferimenti e istruzione Imports (Visual Basic)

È 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.

Dichiarazione di Importazione

Gli assembly includono uno o più namespace. 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 ha la sintassi seguente:

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 di progetto, tramite una definizione all'interno del progetto o tramite un'istruzione precedente Imports .

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

Annotazioni

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 e avanzamento riga che determina la visualizzazione di una singola parte di testo su più righe fa parte del modulo ControlChars nel namespace 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")

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

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

I riferimenti futuri a questo spazio dei nomi possono 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.

Vedere anche