Ajouter une référence, boîte de dialogue
Mise à jour : novembre 2007
La boîte de dialogue Ajouter une référence affiche des volets à onglet contenant les listes des différents types de composants et de projets que vous pouvez rechercher. Pour afficher la boîte de dialogue Ajouter une référence, dans le menu Projet, cliquez sur Ajouter une référence, ou cliquez avec le bouton droit sur le nœud Référence dans l'Explorateur de solutions, puis cliquez sur Ajouter une référence. Dans la boîte de dialogue Ajouter une référence, sélectionnez l'onglet correspondant au type de composant à rechercher.
Remarque : |
---|
Le nombre d'onglets affichés en haut de la boîte de dialogue Ajouter une référence varie en fonction du type du projet ouvert et des ressources que ce projet utilise. En outre, certains composants de la liste peuvent être désactivés et s'afficher en gris selon la version du .NET Framework de votre projet. En effet, certains composants d'une version plus récente du .NET Framework ne sont pas compatibles avec les projets basés sur une version antérieure du .NET Framework. |
La boîte de dialogue Ajouter une référence permet de modifier le fichier de références de projet pour le projet sélectionné. Un fichier de références de projet contient des informations relatives aux conditions d'exécution d'une application ou d'un composant ; il spécifie notamment quels fichiers sont requis, si ceux-ci doivent être inscrits et où ils doivent être installés sur l'ordinateur de l'utilisateur. La boîte de dialogue Ajouter une référence ajoute également les hiérarchies d'objets pour les projets sélectionnés dans la portée d'exploration de l'Affichage de classes et de l'Explorateur d'objets.
Note de sécurité : |
---|
Lors de l'incorporation d'éléments nécessitant l'exécution des autorisations de confiance totale, sachez que peuvent se produire des violations de la sécurité d'accès au code. Pendant le développement, un projet s'exécute en mode confiance totale, mais l'environnement dans lequel le projet est déployé peut n'être qu'en mode confiance partielle. Au moment de l'exécution, si l'environnement bénéficie d'un niveau de confiance partiel, des violations de la sécurité d'accès du code risquent de se produire. Il est donc nécessaire de tester les applications dans différents scénarios de niveau de confiance. |
Les onglets et contrôles suivants sont disponibles :
Onglet .NET
Répertorie tous les composants .NET Framework pouvant être référencés.Composant
Description
Nom du composant
Soit le nom complet, sort le nom « convivial » du composant.
Version
Numéro de version du composant.
Runtime
Numéro de version du .NET Framework avec lequel le composant a été créé.
Chemin d'accès
Le chemin d'accès au dossier et nom de fichier du composant.
Onglet COM
Répertorie tous les composants COM pouvant être référencés.Remarque : Cet onglet n'apparaît pas pendant le développement de projets Smart Device.
Onglet Projets
Répertorie les projets Visual Studio de la solution actuelle pouvant être référencés. Sélectionnez les assemblys à partir de cet onglet pour créer des références entre projets.Composant
Description
Nom du projet
Affiche les noms des projets référencés.
Répertoire du projet
Affiche le chemin d'accès au dossier des projets référencés.
Onglet Parcourir
Vous permet de naviguer jusqu'à un composant non répertorié dans l'onglet actuel, et de l'ajouter à la liste.Onglet Récent
Affiche les références récemment ajoutées.Composant
Description
Nom du composant
Soit le nom complet, sort le nom « convivial » du composant.
Type
Type des composants répertoriés.
Version
Numéro de version du composant.
Source
Nom de fichier du composant et chemin d'accès au dossier de son emplacement.
Affichage d'un assembly dans la boîte de dialogue Ajouter une référence
La boîte de dialogue Ajouter une référence n'affiche pas automatiquement chaque assembly, même s'il a été installé dans le GAC (Global Assembly Cache). La boîte de dialogue Ajouter une référence est basée sur le chemin d'accès, et il existe plusieurs moyens d'afficher un assembly :
Déplacez ou copiez l'assembly vers le répertoire du projet en cours (vous pouvez rechercher ces assemblys à l'aide de l'onglet Parcourir), vers d'autres répertoires de projet de la même solution (vous pouvez rechercher ces assemblys à l'aide de l'onglet Projets) ou vers le dossier Public Assemblys (Program Files\Microsoft Visual Studio .NET\Common7\IDE\Public Assemblies) ; ces assemblys peuvent être trouvés sous l'onglet .NET.
Définissez un chemin d'accès de référence au répertoire contenant l'assembly à l'aide de la Chemins d'accès des références, boîte de dialogue (Visual Basic) ou du Chemins d'accès des références, page du Concepteur de projets (C#).
Définissez une clé de Registre qui spécifie l'emplacement des assemblys à afficher.
Pour connaître les procédures détaillées sur la façon d'afficher un assembly dans la boîte de dialogue Ajouter une référence, consultez Comment : ajouter ou supprimer des références dans Visual Studio (Visual Basic).
La liste des références dépend de la cible .NET Framework
Les composants de référence affichés dans la boîte de dialogue Ajouter une référence sont liés à la version du .NET Framework utilisé dans le projet. Les composants ne concernant pas la cible .NET Framework du projet apparaissent en gris dans la liste et ne peuvent pas être ajoutés comme référence au projet.
Voir aussi
Tâches
Comment : ajouter ou supprimer des références dans Visual Studio (Visual Basic)
Comment : ajouter et supprimer des références dans Visual Studio (C#)
Comment : afficher et modifier la portée de l'exploration
Comment : naviguer dans l'Explorateur d'objets
Comment : rechercher des objets, des définitions et des références (symboles)
Concepts
Projets en tant que conteneurs
Gestion des éléments dans les projets
Référence
Choisir des éléments de boîte à outils, boîte de dialogue (Visual Studio)