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

  • Article

Mise à jour : novembre 2007

Importe des espaces de noms ou des éléments de programmation définis dans le projet actuel ou dans les projets et les assemblys référencés.

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

Éléments

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

  • 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

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.

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 « Classes avec le même nom » dans Résolution d'une référence lorsque plusieurs variables ont le même nom.

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ésolution d'une référence lorsque plusieurs variables ont le même nom.

Remarque :

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.

Règles

  • Nom de l'alias. 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.

  • Nom de l'espace de noms. 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

  • Type d'élément. 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.

Comportement

  • Portée. 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.

  • Qualification. Le code présent à l'extérieur d'un espace de noms ou d'un élément conteneur doit qualifier normalement le nom d'un membre avec le nom de cet espace de noms de l'élément conteneur. L'instruction Imports rend cette qualification inutile à moins que votre projet ait accès à un autre membre dont le nom est identique. Dans ce cas, vous pouvez spécifier aliasname dans chaque instruction Imports. Ensuite, vous n'avez besoin que des alias d'importation pour qualifier les membres portant le même nom.

Exemple

L'exemple suivant importe la classe Microsoft.VisualBasic.Strings et assigne un alias, str, pouvant être utilisé pour accéder à la méthode 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

Notez que l'exemple précédent importe un espace de noms imbriqué, Strings dans VisualBasic dans Microsoft. Lorsque MsgBox, fonction (Visual Basic) accède à la méthode Left, il peut utiliser l'alias str au lieu de l'ensemble de la chaîne de qualification Microsoft.VisualBasic.Strings.

Voir aussi

Concepts

Introduction à la bibliothèque de classes .NET Framework dans Visual Studio

Espaces de noms dans Visual Basic

Référence

Namespace, instruction

Imports, instruction (espace de noms XML)

Autres ressources

Visual Basic et le .NET Framework