Partager via


Références et l'instruction Imports

Mise à jour : novembre 2007

Vous pouvez rendre les objets externes disponibles pour votre projet en cliquant sur la commande Ajouter une référence dans le menu Projet. Les références en Visual Basic peuvent pointer vers des assemblys qui ressemblent à des bibliothèques de types, mais contiennent plus d'informations.

L'instruction Imports

Les assemblys incluent un ou plusieurs espaces de noms. Lorsque vous ajoutez une référence à un assembly, vous pouvez également ajouter une instruction Importsà un module pour contrôler la visibilité des espaces de noms de l'assembly dans le module. L'instruction Imports offre une portée qui vous permet d'utiliser uniquement la portion d'espace de noms nécessaire pour fournir une référence unique.

La syntaxe de l'instruction Imports est la suivante :

Imports [|Aliasname =] Namespace

Aliasname fait référence à un nom court que vous pouvez utiliser dans code pour faire référence à un espace de noms importé. Namespace est un espace de noms disponible par le biais d'une référence de projet, d'une définition dans le projet ou d'une instruction Imports antérieure.

Un module peut contenir autant d'instructions Imports que vous le souhaitez. Celles-ci doivent apparaître après toutes les instructions Option, le cas échéant, mais avant tout autre code.

Remarque :

Ne confondez pas les références de projet avec les instructions Imports ou Declare. Les références de projet rendent les objets externes, tels que les objets des assemblys, disponibles pour les projets Visual Basic. L'utilisation de l'instruction Imports permet de simplifier l'accès aux références de projet, mais ne constitue pas un accès à ces objets. L'instruction Declare permet de déclarer une référence à une procédure externe dans une bibliothèque de liens dynamiques (DLL).

Utilisation des alias avec l'instruction Imports

L'instruction Imports facilite l'accès aux méthodes des classes en éliminant le besoin d'entrer de manière explicite les noms complets des références. Les alias vous permettent d'assigner un nom plus convivial à seulement une partie d'un espace de noms. Par exemple, la séquence du retour chariot ou du changement de ligne qui entraîne l'affichage d'un bloc de texte sur plusieurs lignes fait partie du module ControlChars, module (Visual Basic) de l'espace de noms Microsoft.VisualBasic. Pour utiliser cette constante dans un programme sans recourir à un alias, vous devez entrer le code suivant :

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

Les instructions Imports doivent toujours représenter les premières lignes situées immédiatement après les instructions Option d'un module. Le fragment de code suivant montre comment importer et assigner un alias au module Microsoft.VisualBasic.ControlChars:

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

Les références ultérieures à cet espace de noms peuvent être considérablement plus courtes :

MsgBox("Some text" & CtrlChrs.CrLf & "Some more text")

Si une instruction Imports n'inclut pas de nom d'alias, les éléments définis dans l'espace de noms importé peuvent être utilisés dans le module sans nécessiter de qualification. Si le nom d'alias est spécifié, il doit être utilisé comme qualificateur pour les noms contenus dans l'espace de noms.

Voir aussi

Tâches

Comment : ajouter ou supprimer des références dans Visual Studio (Visual Basic)

Comment : créer et utiliser des assemblys

Concepts

Espaces de noms dans Visual Basic

Assemblys

Référence

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

ControlChars, module (Visual Basic)

Microsoft.VisualBasic

Autres ressources

Modifications du langage pour les utilisateurs de Visual Basic 6.0