Partager via

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

Vous pouvez rendre les objets externes disponibles pour 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 contiennent plus d’informations.

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 Imports instruction à un module qui contrôle la visibilité des espaces de noms de cet assembly au sein du module. L’instruction Imports fournit un contexte d’étendue 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 via une référence de projet, par le biais d’une définition dans le projet ou d’une instruction précédente Imports .

Un module peut contenir n’importe quel nombre d’instructions Imports . Elles doivent apparaître après toutes Option les instructions, le cas échéant, mais avant tout autre code.

Remarque

Ne confondez pas les références de projet avec l’instruction Imports ou l’instruction Declare . Les références de projet rendent des objets externes, tels que des objets dans des assemblys, disponibles pour les projets Visual Basic. L’instruction Imports est utilisée pour simplifier l’accès aux références de projet, mais elle 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 la nécessité de taper explicitement les noms qualifiés 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 de retour chariot/flux de ligne qui entraîne l’affichage d’un seul élément de texte sur plusieurs lignes fait partie du module de l’espace ControlCharsMicrosoft.VisualBasic de noms. 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")

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

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

Les futures références à cet espace de noms peuvent être beaucoup plus courtes :

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

Si une Imports instruction 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