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

  • Article

Vous pouvez mettre des objets externes à disposition dans votre projet en choisissant la commande Ajouter une référence dans le menu Projet. Les références dans Visual Basic peuvent pointer vers des assemblys, qui sont comme des bibliothèques de types, mais qui contiennent plus d’informations.

L’instruction Imports

Les assemblys contiennent un ou plusieurs espaces de noms. Lorsque vous ajoutez une référence à un assembly, vous pouvez également ajouter une instruction Imports à un module qui contrôle la visibilité des espaces de noms de cet assembly au sein du module. L’instruction Imports fournit un contexte de portée qui vous permet d’utiliser uniquement la partie de l’espace de noms nécessaire pour fournir une référence unique.

L'instruction Imports a la syntaxe suivante :

Imports [Aliasname =] Namespace

Aliasname fait référence à un nom court que vous pouvez utiliser dans le 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 précédente.

Un module peut contenir autant d’instructions Imports que nécessaire. Elles doivent apparaître après toute instruction Option, le cas échéant, mais avant tout autre code.

Notes

Ne confondez pas les références de projet avec l’instruction Imports ou l’instruction Declare. Les références de projet mettent les objets externes, tels que les objets dans les assemblys, à disposition dans les projets Visual Basic. L’instruction Imports est utilisée pour simplifier l’accès aux références de projet, mais ne fournit pas l’accès à ces objets. L’instruction Declare est utilisée pour déclarer une référence à une procédure externe dans une bibliothèque de liens dynamiques (DLL).

Utilisation d’alias avec l’instruction Imports

L’instruction Imports facilite l’accès aux méthodes de classes en éliminant le besoin de taper explicitement les noms complets des références. Les alias vous permettent d’attribuer un nom plus convivial à une seule partie d’un espace de noms. Par exemple, la séquence retour chariot/saut de ligne qui entraîne l’affichage d’un seul morceau de texte sur plusieurs lignes fait partie du module ControlChars dans l’espace de noms Microsoft.VisualBasic. Pour utiliser cette constante dans un programme sans alias, vous devez taper le code suivant :

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

Les instructions Imports doivent toujours être les premières lignes qui suivent immédiatement les instructions Option dans un module. Le fragment de code suivant montre comment importer et affecter un alias au module Microsoft.VisualBasic.ControlChars :

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

Les références futures à 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 qualification. Si le nom d’alias est spécifié, il doit être utilisé comme qualificateur pour les noms contenus dans cet espace de noms.

Voir aussi