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

Configurations de génération

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)

Parcours du code et des composants