Istruzione Imports (tipo e spazio dei nomi .NET)

Aggiornamento: novembre 2007

Importa spazi dei nomi o elementi di programmazione definiti nel progetto corrente o in progetti e assembly a cui viene fatto riferimento.

Imports [ aliasname = ] namespace
-or-
Imports [ aliasname = ] namespace.element

Parti

• aliasname
  Facoltativa. Alias di importazione o nome per mezzo del quali il codice può fare riferimento a namespace invece di utilizzare la stringa di qualificazione completa. Per informazioni, vedere Nomi di elementi dichiarati.

• namespace
  Obbligatoria. Nome completo dello spazio dei nomi da importare. Può essere una stringa di spazi dei nomi nidificata a qualsiasi livello.

• element
  Facoltativa. Nome di un elemento di programmazione dichiarato nello spazio dei nomi. Può essere un qualsiasi elemento contenitore.

Note

Ogni file di origine può contenere un numero indefinito di istruzioni Imports. Queste devono essere specificate dopo le dichiarazioni di opzione, come l'istruzione Option Strict, e devono precedere qualsiasi dichiarazione di elemento di programmazione, come ad esempio le istruzioni Module o Class.

La parola chiave Imports può essere utilizzata solo a livello di file. In altri termini, il contesto della dichiarazione per l'importazione deve essere un file di origine, e non uno spazio dei nomi, una classe, una struttura, un modulo, un'interfaccia, una routine o un blocco.

Gli alias di importazione si rivelano utili quando è necessario utilizzare elementi omonimi dichiarati in uno o più spazi dei nomi. Per ulteriori informazioni e un esempio, vedere "Classi con lo stesso nome" in Risoluzione di un riferimento quando più variabili hanno lo stesso nome.

Tenere presente che l'istruzione Imports non rende disponibili per il progetto elementi di altri progetti e assembly. In altre parole, l'importazione non è un'alternativa all'impostazione di un riferimento. Essa elimina semplicemente la necessità di qualificare i nomi che sono già disponibili per il progetto. Per ulteriori informazioni, vedere la sezione "Importazione di elementi contenitore" in Risoluzione di un riferimento quando più variabili hanno lo stesso nome.

Nota:

Anche se la sintassi utilizzata per dichiarare un alias di importazione è uguale a quella utilizzata per importare un prefisso dello spazio dei nomi XML, i risultati sono diversi. Un alias di importazione può essere utilizzato come un'espressione nel codice, mentre un prefisso dello spazio dei nomi XML può essere utilizzato solo in valori letterali XML o proprietà axis XML come prefisso di un nome di attributo o elemento qualificato.

Regole

• Nome di alias. Evitare di dichiarare un membro a livello di modulo con la stesso nome di aliasname. In caso contrario, il compilatore di Visual Basic utilizza il aliasname soltanto per il membro dichiatato e non lo riconosce più come alias di importazione.

• Nome dello spazio dei nomi. È possibile fornire un singolo nome dello spazio dei nomi o una stringa di spazi dei nomi nidificati. Ciascuno spazio dei nomi nidificato è separato dallo spazio dei nomi successivo di livello più alto da un punto (.) come illustrato nell'esempio riportato di seguito.

  Imports System.Collections.Generic

• Tipo di elemento. Se si fornisce un parametro element, esso deve rappresentare un elemento contenitore, ovvero un elemento di programmazion e che possa contenere altri elementi. Gli elementi contenitore comprendono classi, strutture, moduli, interfacce ed enumerazioni.

Comportamento

• Ambito. L'ambito degli elementi resi disponibili mediante un'istruzione Imports è legato al fatto che venga o non venga specificato element. Se si specifica soltanto il parametro namespace, tutti i membri con nome univoco di quello spazio dei nomi e i membri di elementi contenitore inclusi in quello spazio dei nomi, sono disponibili senza qualificazione. Se si specifica sia namespace che element, saranno disponibili senza qualificazione soltanto i membri di quell'elemento.

• Qualificazione. Il codice al di fuori di uno spazio dei nomi o di un elemento contenitore deve tipicamente qualificare il nome di un membro con il nome di quello spazio dei nomi o elemento contenitore. L'istruzione Imports rende superflua questa qualificazione, a meno che il progetto non abbia accesso a un altro membro con lo stesso nome. In tal caso è possibile specificare un aliasname in ciascuna istruzione Imports. Quindi saranno necessari soltanto gli aliasi di iimportazione per qualificare i membri con n lo stesso nome.

Esempio

Nell'esempio seguente viene importata la classe Microsoft.VisualBasic.Strings e le viene assegnato l'alias str, che può essere utilizzato per accedere al metodo Left.

' Place Imports statements at the top of your program.
Imports str = Microsoft.VisualBasic.Strings

Class testClass1
    Sub showHello()
        ' Display only the word "Hello"
        MsgBox(str.Left("Hello World", 5))
    End Sub
End Class

Notare che nell'esempio precedente viene importato uno spazio dei nomi nidificato, Strings all'interno di VisualBasic all'interno di Microsoft. Quando la Funzione MsgBox (Visual Basic) accede al metodo Left, può utilizzare l'alias str invece dell'intera stringa di qualificazione Microsoft.VisualBasic.Strings.

Vedere anche

Concetti

Introduzione alla libreria di classi .NET Framework in Visual Studio

Spazi dei nomi in Visual Basic

Riferimenti

Istruzione Namespace

Istruzione Imports (spazio dei nomi XML)

Altre risorse

Visual Basic e .NET Framework