Riferimenti e istruzione Imports (Visual Basic)
È 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 si riferisce a un nome breve che è possibile utilizzare all'interno del codice per fare riferimento a uno spazio dei nomi importato. Namespace è uno spazio dei nomi disponibile tramite un riferimento al 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 ControlChars 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
Procedura: creare e utilizzare assembly dalla riga di comando (C# e Visual Basic)
Riferimenti
Istruzione Imports (tipo e spazio dei nomi .NET)