Exporter (0) Imprimer
Développer tout

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


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.

Hiérarchie d'espace de noms

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.

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.

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.

zt9tafza.alert_note(fr-fr,VS.90).gifRemarque :

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.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft