Partager via


Espaces de noms dans Visual Basic

Mise à jour : novembre 2007

Les espaces de noms permettent d'organiser les objets définis dans un assembly. Les assemblys peuvent contenir plusieurs espaces de noms, qui peuvent à leur tour contenir d'autres espaces de noms. Les espaces de noms permettent d'éviter les ambiguïtés et de simplifier les références lors de l'utilisation de grands groupes d'objets, tels que les bibliothèques de classes.

Par exemple, .NET Framework définit la classe ListBox de l'espace de noms System.Windows.Forms. Le fragment de code suivant montre comment déclarer une variable en utilisant le nom complet de cette classe :

Dim LBox As System.Windows.Forms.ListBox

Comment éviter les collisions de noms

Les espaces de noms .NET Framework traitent un problème que l'on appelle parfois « encombrement des espaces de noms », dans lequel le développeur d'une bibliothèque de classes est gêné par l'utilisation de noms similaires dans une bibliothèque différente. Ces conflits avec des composants existants sont parfois appelés collisions de noms.

Par exemple, si vous créez une nouvelle classe nommée ListBox, vous pouvez l'utiliser dans votre projet sans qualification. Cependant, si vous souhaitez utiliser la classe .NET FrameworkListBox dans le même projet, vous devez utiliser une référence qualifiée complète pour lui donner son caractère unique. Si la référence n'est pas unique, Visual Basic génère une erreur en indiquant que le nom est ambigu. L'exemple de code suivant montre comment déclarer ces objets :

' Define a new object based on your ListBox class.
Dim LBC As New ListBox
' Define a new Windows.Forms ListBox control.
Dim MyLB As New System.Windows.Forms.ListBox

L'illustration suivante montre deux hiérarchies d'espaces de noms, chacune contenant un objet nommé ListBox.

Par défaut, tous les fichiers exécutables créés à l'aide de Visual Basic contiennent un espace de noms portant le même nom que votre projet. Par exemple, si vous définissez un objet dans un projet nommé ListBoxProject, le fichier exécutable, ListBoxProject.exe, contient un espace de noms appelé ListBoxProject.

Plusieurs assemblys peuvent utiliser le même espace de noms. Visual Basic les traite comme un seul ensemble de noms. Par exemple, vous pouvez définir des classes pour un espace de noms appelé SomeNameSpace dans un assembly nommé Assemb1, et définir des classes supplémentaires pour le même espace de noms à partir d'un assembly nommé Assemb2.

Noms complets

Les noms complets sont des références d'objet qui sont préfixées à l'aide du nom de l'espace de noms dans lequel l'objet est défini. Vous pouvez utiliser les objets définis dans d'autres projets si vous créez une référence à la classe (en cliquant sur Ajouter une référence dans le menu Projet) et si vous utilisez le nom complet de l'objet dans votre code. Le fragment de code suivant montre comment utiliser le nom complet d'un objet provenant de l'espace de noms d'un autre projet :

Dim LBC As New ListBoxProject.Form1.ListBox

Les noms complets empêchent les conflits d'attribution de noms parce qu'ils permettent au compilateur de déterminer l'objet utilisé. Cependant, ces noms peuvent devenir longs et encombrants. Pour contourner ce problème, utilisez l'instruction Imports pour définir un alias (nom abrégé que vous pouvez utiliser à la place d'un nom complet). Par exemple, l'exemple de code suivant crée les alias de deux noms complets, puis utilise ces alias pour définir deux objets.

Imports LBControl = System.Windows.Forms.ListBox
Imports MyListBox = ListBoxProject.Form1.ListBox
Dim LBC As LBControl
Dim MyLB As MyListBox

Si vous utilisez l'instruction Imports sans alias, vous pouvez vous servir de tous les noms de l'espace de noms sans qualification, à condition qu'ils soient uniques à l'intérieur du projet. Si votre projet contient des instructions Imports pour les espaces de noms contenant des éléments qui portent le même nom, vous devez fournir un nom complet lorsque vous l'utilisez. Supposons, par exemple, que votre projet contienne les deux instructions Imports suivantes :

' This namespace contains a class called Class1.
Imports MyProj1
' This namespace also contains a class called Class1.
Imports MyProj2

Si vous essayez d'utiliser Class1 sans fournir son nom complet, Visual Basic génère une erreur en indiquant que le nom Class1 est ambigu.

Instructions au niveau de l'espace de noms

Dans un espace de noms, vous pouvez définir des éléments tels que des modules, des interfaces, des classes, des délégués, des énumérations, des structures et d'autres espaces de noms. Vous ne pouvez pas définir les éléments tels que les propriétés, les procédures, les variables et les événements au niveau de l'espace de noms. Ces éléments doivent être déclarés dans des conteneurs tels que les modules, les structures ou les classes.

Remarque :

Si vous avez défini une hiérarchie imbriquée d'espaces de noms, le code à l'intérieur de cette hiérarchie peut ne pas pouvoir accéder aux classes à l'intérieur d'autres espaces de noms ayant le même nom. Par exemple, si vous définissez un espace de noms nommé System dans un espace de noms nommé SpecialSpace, les membres de l'espace de noms System du .NET Framework ne seront pas accessibles à moins que vous ne qualifiiez complètement les membres avec le mot clé Global. Pour plus d'informations, consultez Global.

Voir aussi

Tâches

Comment : créer et utiliser des assemblys

Concepts

Assemblys

Références et l'instruction Imports

Référence

Global

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

ListBox

System.Windows.Forms

Autres ressources

Modifications du langage pour les utilisateurs de Visual Basic 6.0