Condividi tramite


Riferimenti e istruzione Imports

Aggiornamento: novembre 2007

È possibile rendere disponibili per il progetto oggetti esterni scegliendo il comando Aggiungi riferimento dal menu Progetto. I riferimenti di Visual Basic possono essere relativi ad assembly, ossia oggetti simili a librerie di tipi ma in grado di contenere una maggiore quantità di informazioni.

Istruzione Imports

Gli assembly comprendono 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 utilizzare solamente la parte dello spazio dei nomi necessaria per fornire un riferimento univoco.

Di seguito è riportata la sintassi dell'istruzione Imports.

Imports [|Aliasname =] Namespace

Aliasname indica un nome abbreviato che è possibile utilizzare per fare riferimento a uno spazio dei nomi importato. Namespace è uno spazio dei nomi disponibile tramite un riferimento a un progetto, una definizione all'interno del progetto o un'istruzione Imports precedente.

Un modulo può contenere un numero qualsiasi di istruzioni Imports. Tali istruzioni devono essere visualizzate dopo eventuali istruzioni Option ma prima di qualsiasi altro codice.

Nota:

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

Utilizzo degli alias con l'istruzione Imports

L'istruzione Imports semplifica l'accesso ai metodi delle classi, eliminando la necessità di digitare in modo esplicito il nome completo 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 porzione di testo su più righe fa parte del modulo Modulo ControlChars (Visual Basic) nello spazio dei nomi Microsoft.VisualBasic. Per utilizzare questa costante in un programma, senza un alias, sarebbe necessario digitare il codice che segue:

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

Le istruzioni Imports devono essere sempre contenute nelle prime righe immediatamente successive alle istruzioni Option in un modulo. Nel frammento di codice riportato di seguito viene illustrato come importare e assegnare un alias al modulo Microsoft.VisualBasic.ControlChars:

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

I riferimenti successivi a questo spazio dei nomi possono essere molto 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 utilizzati nel modulo senza qualificazione. Se il nome alias è specificato, deve essere utilizzato come qualificatore per i nomi contenuti all'interno di quello spazio dei nomi.

Vedere anche

Attività

Procedura: aggiungere o rimuovere riferimenti in Visual Studio (Visual Basic)

Procedura: creare e utilizzare gli assembly

Concetti

Spazi dei nomi in Visual Basic

Assembly

Riferimenti

Istruzione Imports (tipo e spazio dei nomi .NET)

Modulo ControlChars (Visual Basic)

Microsoft.VisualBasic

Altre risorse

Modifiche al linguaggio per gli utenti di Visual Basic 6.0