Références et l'instruction Imports (Visual Basic)References and the Imports Statement (Visual Basic)

Vous pouvez rendre des objets externes disponibles pour votre projet en sélectionnant la commande Ajouter une référence dans le menu projet .You can make external objects available to your project by choosing the Add Reference command on the Project menu. Les références dans Visual Basic peuvent pointer vers des assemblys, comme les bibliothèques de types, mais contiennent davantage d’informations.References in Visual Basic can point to assemblies, which are like type libraries but contain more information.

Instruction ImportsThe Imports Statement

Les assemblys incluent un ou plusieurs espaces de noms.Assemblies include one or more namespaces. 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 dans le module.When you add a reference to an assembly, you can also add an Imports statement to a module that controls the visibility of that assembly's namespaces within the 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.The Imports statement provides a scoping context that lets you use only the portion of the namespace necessary to supply a unique reference.

L’instruction Imports a la syntaxe suivante :The Imports statement has the following syntax:

Imports [Aliasname =] Namespace

Aliasname fait référence à un nom abrégé que vous pouvez utiliser dans le code pour faire référence à un espace de noms importé.Aliasname refers to a short name you can use within code to refer to an imported namespace. 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 par le biais d’une instruction Imports précédente.Namespace is a namespace available through either a project reference, through a definition within the project, or through a previous Imports statement.

Un module peut contenir un nombre quelconque d’instructions Imports.A module may contain any number of Imports statements. Ils doivent apparaître après les instructions Option, le cas échéant, mais avant tout autre code.They must appear after any Option statements, if present, but before any other code.

Notes

Ne confondez pas les références de projet avec l’instruction Imports ou l’instruction Declare.Do not confuse project references with the Imports statement or the Declare statement. Les références de projet rendent des objets externes, tels que des objets dans les assemblys, accessibles aux projets Visual Basic.Project references make external objects, such as objects in assemblies, available to Visual Basic projects. 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.The Imports statement is used to simplify access to project references, but does not provide access to these objects. L’instruction Declare permet de déclarer une référence à une procédure externe dans une bibliothèque de liens dynamiques (DLL).The Declare statement is used to declare a reference to an external procedure in a dynamic-link library (DLL).

Utilisation d’alias avec l’instruction ImportsUsing Aliases with the Imports Statement

Grâce à l’instruction Imports, il est plus facile d’accéder aux méthodes des classes en éliminant le besoin de taper explicitement les noms complets des références.The Imports statement makes it easier to access methods of classes by eliminating the need to explicitly type the fully qualified names of references. Les alias vous permettent d’assigner un nom plus convivial à une seule partie d’un espace de noms.Aliases let you assign a friendlier name to just one part of a namespace. Par exemple, la séquence de retour chariot/saut de ligne qui provoque l’affichage d’une seule partie du texte sur plusieurs lignes fait partie du module ControlChars dans l’espace de noms Microsoft.VisualBasic.For example, the carriage return/line feed sequence that causes a single piece of text to be displayed on multiple lines is part of the ControlChars module in the Microsoft.VisualBasic namespace. Pour utiliser cette constante dans un programme sans alias, vous devez taper le code suivant :To use this constant in a program without an alias, you would need to type the following code:

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

Imports instructions doivent toujours être les premières lignes qui suivent immédiatement les instructions Option dans un module.Imports statements must always be the first lines immediately following any Option statements in a module. Le fragment de code suivant montre comment importer et assigner un alias au module Microsoft.VisualBasic.ControlChars :The following code fragment shows how to import and assign an alias to the Microsoft.VisualBasic.ControlChars module:

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

Les futures références à cet espace de noms peuvent être beaucoup plus courtes :Future references to this namespace can be considerably shorter:

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.If an Imports statement does not include an alias name, elements defined within the imported namespace can be used in the module without qualification. Si le nom d’alias est spécifié, il doit être utilisé en tant que qualificateur pour les noms contenus dans cet espace de noms.If the alias name is specified, it must be used as a qualifier for names contained within that namespace.

Voir aussiSee also