Imports, instruction (espace de noms et type .NET)

Permet le référencement des noms de types sans qualification d'espace de noms.

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

Composants

Terme	Définition
aliasname	Facultatif. Alias d'importation ou nom par lequel le code peut faire référence à namespace au lieu de la chaîne de qualification complète. Consultez Noms d'éléments déclarés (Visual Basic).
namespace	Obligatoire. Nom qualifié complet de l'espace de noms importé. Il peut s'agir d'une chaîne d'espaces de noms imbriqués à un niveau quelconque.
element	Facultatif. Nom d'un élément de programmation déclaré dans l'espace de noms. Il peut s'agir de n'importe quel élément conteneur.

Notes

L'instruction Imports permet le référencement direct des types contenus dans un espace de noms donné.

Vous pouvez fournir un nom d'espace de noms unique ou une chaîne d'espaces de noms imbriqués. Chaque espace de noms imbriqué est séparé de l'espace de noms du niveau supérieur suivant par un point (.), comme l'exemple suivant l'illustre.

Imports System.Collections.Generic

Chaque fichier source peut contenir un nombre quelconque d'instructions Imports. Celles-ci doivent suivre les déclarations d'option telles que l'instruction Option Strict, et elles doivent précéder les déclarations d'élément de programmation telles que les instructions Module ou Class.

Vous pouvez utiliser Imports seulement au niveau du fichier. Cela signifie que le contexte de déclaration pour l'importation doit être un fichier source, et ne peut pas être un espace de noms, une classe, une structure, un module, une interface, une procédure ou un bloc.

Notez que l'instruction Imports ne rend pas d'éléments d'autres projets et assemblys disponibles à votre projet. L'importation ne prend pas la place de la définition d'une référence. Elle rend inutile la qualification des noms qui sont déjà disponibles pour votre projet. Pour plus d'informations, consultez « Importation d'éléments conteneurs » dans Références aux éléments déclarés (Visual Basic).

Notes

Vous pouvez définir des instructions implicites Imports en utilisant le Page Références, Concepteur de projets (Visual Basic).Pour plus d'informations, consultez Comment : ajouter ou supprimer des espaces de noms importés (Visual Basic).

Alias d'importation

Un nouvel alias d'importation définit l'alias pour un espace de noms ou un type. Les alias d'importation sont utiles lorsque vous devez utiliser des éléments portant le même nom et qui sont déclarés dans un ou plusieurs espaces de noms. Pour plus d'informations et pour obtenir un exemple, consultez « Qualification d'un nom d'élément » dans Références aux éléments déclarés (Visual Basic).

Vous ne devez pas déclarer de membre au niveau du module avec le même nom que aliasname. Sinon, le compilateur Visual Basic utilise uniquement aliasname pour le membre déclaré et ne le reconnaît plus comme alias d'importation.

Bien que la syntaxe utilisée pour déclarer un alias d'importation soit similaire à celle utilisée pour importer un préfixe d'espace de noms XML, les résultats sont différents. Un alias d'importation peut être utilisé comme une expression dans le code, alors qu'un préfixe d'espace de noms XML peut être utilisé uniquement dans les littéraux XML ou les propriétés d'axe XML comme préfixe pour un élément qualifié ou nom de l'attribut.

Noms d'éléments

Si vous fournissez element, il doit représenter un élément conteneur, c'est-à-dire un élément de programmation qui peut contenir d'autres éléments. Les éléments conteneurs comprennent des classes, structures, modules, interfaces et énumérations.

La portée des éléments mis à disposition par une instruction Imports varie selon que vous spécifiez element. Si vous spécifiez uniquement namespace, tous les membres à nom unique de cet espace de noms ainsi que les membres des éléments conteneurs présents dans cet espace de noms, sont disponibles sans qualification. Si vous spécifiez namespace et element, seuls les membres de cet élément sont disponibles sans qualification.

Exemple

L'exemple suivant retourne tous les dossiers dans le répertoire C:\ à l'aide de la classe DirectoryInfo.

Le code n'a aucune instruction Imports en haut du fichier. Par conséquent, les références DirectoryInfo, StringBuilder et CrLf sont entièrement qualifiées avec les espaces de noms.

Public Function GetFolders() As String 
    ' Create a new StringBuilder, which is used 
    ' to efficiently build strings. 
    Dim sb As New System.Text.StringBuilder

    Dim dInfo As New System.IO.DirectoryInfo("c:\")

    ' Obtain an array of directories, and iterate through 
    ' the array. 
    For Each dir As System.IO.DirectoryInfo In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(Microsoft.VisualBasic.ControlChars.CrLf)
    Next 

    Return sb.ToString
End Function

L'exemple suivant inclut des instructions Imports pour les espaces de noms référencés. Par conséquent, les types n'ont pas à être entièrement qualifiés avec les espaces de noms.

' Place Imports statements at the top of your program. 
Imports System.Text
Imports System.IO
Imports Microsoft.VisualBasic.ControlChars

Public Function GetFolders() As String 
    Dim sb As New StringBuilder

    Dim dInfo As New DirectoryInfo("c:\")
    For Each dir As DirectoryInfo In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(CrLf)
    Next 

    Return sb.ToString
End Function

L'exemple suivant inclut des instructions Imports qui créent des alias pour les espaces de noms référencés. Les types sont qualifiés avec les alias.

Imports systxt = System.Text
Imports sysio = System.IO
Imports ch = Microsoft.VisualBasic.ControlChars

Public Function GetFolders() As String 
    Dim sb As New systxt.StringBuilder

    Dim dInfo As New sysio.DirectoryInfo("c:\")
    For Each dir As sysio.DirectoryInfo In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(ch.CrLf)
    Next 

    Return sb.ToString
End Function

L'exemple suivant inclut des instructions Imports qui créent des alias pour les types référencés. Alias utilisés pour spécifier les types.

Imports strbld = System.Text.StringBuilder
Imports dirinf = System.IO.DirectoryInfo

Public Function GetFolders() As String 
    Dim sb As New strbld

    Dim dInfo As New dirinf("c:\")
    For Each dir As dirinf In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(ControlChars.CrLf)
    Next 

    Return sb.ToString
End Function

Voir aussi

Référence

Namespace, instruction

Imports, instruction (espace de noms XML)

Concepts

Espaces de noms dans Visual Basic

Références et l'instruction Imports (Visual Basic)

Références aux éléments déclarés (Visual Basic)