Comment : ajouter ou supprimer des références à l'aide de la boîte de dialogue Ajouter une référence

  • Article

Pour utiliser un composant dans votre application, vous devez d'abord y ajouter une référence.Visual Studio fournit cinq options dans la boîte de dialogue Ajouter une référence :

  • .NET répertorie tous les composants .NET Framework pouvant être référencés.

  • COM répertorie tous les composants COM pouvant être référencés.

  • Projets répertorie tous les composants réutilisables créés à partir de projets locaux.

  • Parcourir vous permet de naviguer à la recherche d'un composant dans le système de fichiers.

  • Récent contient une liste des composants récemment ajoutés à des projets sur votre ordinateur.

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.Les projets natifs C++ contiennent uniquement un onglet Projets.

Certains composants dans la liste peuvent ne pas être indiqués, selon la version .NET Framework de votre projet.Cela peut se produire dans les conditions suivantes :

  • Un composant qui utilise une version récente du .NET Framework est incompatible avec un projet qui cible une version antérieure du .NET Framework.

    Pour plus d'informations sur la modification de la version cible du .NET Framework dans un projet, consultez Comment : cibler une version du .NET Framework.

  • Un composant qui utilise le .NET Framework 4 est incompatible avec un projet qui cible le .NET Framework 4 Client Profile.

    Lorsque vous créez une application, certains projets ciblent le .NET Framework 4 Client Profile par défaut.Pour plus d'informations, consultez .NET Framework Client Profile.

Vous ne pouvez pas ajouter de références à partir du Global Assembly Cache, car il fait strictement partie de l'environnement d'exécution.

Si vous déployez ou copiez une application qui contient une référence à un composant personnalisé enregistré dans le Global Assembly Cache, ce composant ne sera pas déployé ni copié avec l'application, quelle que soit la valeur du paramètre Copy Local.Pour plus d'informations, consultez Gestion des références de projet.

Vous pouvez créer des applications qui référencent des projets ou des assemblys ciblant une version différente du .NET Framework.Par exemple, vous pouvez créer une application ciblant .NET Framework 4 Client Profile qui référence un assembly ciblant .NET Framework 2,0.Si vous créez un projet ciblant une version antérieure du .NET Framework, vous ne pouvez pas définir une référence à un projet ou à un assembly qui cible le .NET Framework 4 Client Profile ou le .NET Framework version 4 dans ce projet.Pour plus d'informations, consultez Détermination d'une version ou d'un profil spécifique du .NET Framework.

Évitez si possible d'ajouter des références de fichier aux sorties d'un autre projet de la même solution, car cela risquerait de provoquer des erreurs de compilation.Utilisez l'onglet Projets de la boîte de dialogue Ajouter une référence afin de créer des références entre projets.Cela facilite le développement en équipe, en permettant une meilleure gestion des bibliothèques de classes créées dans vos projets.Pour plus d'informations, consultez Dépannage de références rompues.

[!REMARQUE]

Dans Visual Studio 2010, une référence de fichier est créée au lieu d'une référence de projet si la version cible du .NET Framework d'un projet est 4 et si la version cible du .NET Framework de l'autre projet est 2.0, 3.0 ou 3.5.

Si vous souhaitez ajouter une référence à une DLL COM inscrite qui contient un manifeste interne, assurez-vous que vous annulez d'abord l'inscription de la DLL.Sinon, Visual Studio ajoute la référence d'assembly comme composant ActiveX, et non comme DLL native.

Vous pouvez également ajouter des références Web à l'aide de la boîte de dialogue Ajouter une référence Web.Pour plus d'informations, consultez How to: Add and Remove Web References.

Lorsque vous ajoutez manuellement une référence à l'un des espaces de noms EnvDTE (EnvDTE, EnvDTE80, EnvDTE90, EnvDTE90a ou EnvDTE100), attribuez la valeur False à la propriété Incorporer les types interop, dans la fenêtre Propriétés.Si cette propriété a la valeur True, des problèmes de génération risquent de survenir car certaines propriétés EnvDTE ne peuvent pas être incorporées.

[!REMARQUE]

Tous les projets contiennent une référence implicite à mscorlib.Les projets Visual Basic contiennent une référence implicite à Microsoft.VisualBasic.

Dans Visual Studio 2010, tous les projets contiennent une référence implicite à System.Core, même si System.Core est supprimé de la liste de références.

Pour afficher un assembly dans la boîte de dialogue Ajouter une référence

  • Déplacez ou copiez l'assembly vers l'un des emplacements suivants :

    • Le répertoire de projet actuel (vous pouvez rechercher ces assemblys à l'aide de l'onglet Parcourir)

    • Autres répertoires de projet de la même solution (vous pouvez rechercher ces assemblys à l'aide de l'onglet Projets)

    - ou -

  • Définissez une clé de Registre qui spécifie l'emplacement des assemblys à afficher :

    Sur un système d'exploitation 32 bits, ajoutez l'une des clés de Registre suivantes :

    • [HKEY_CURRENT_USER\SOFTWARE\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    • [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    Sur un système d'exploitation 64 bits, ajoutez l'une des clés de Registre suivantes dans une ruche du Registre 32 bits  :

    • [HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    • [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    VersionMinimum représente la version la plus ancienne de .NET Framework qui peut être utilisée.Si VersionMinimum a la valeur v3.0, les dossiers spécifiés dans AssemblyFoldersEx s'appliquent aux projets qui ciblent .NET Framework 3.0 et versions ultérieures.

    AssemblyLocation désigne le répertoire des assemblys que vous souhaitez afficher dans la boîte de dialogue Ajouter une référence (par exemple, C:\MyAssemblies\).

    Créer la clé de Registre sous le nœud HKEY_LOCAL_MACHINE permet à tous les utilisateurs de voir les assemblys à l'emplacement spécifié dans la boîte de dialogue Ajouter une référence.Créer la clé de Registre sous le nœud HKEY_CURRENT_USER affecte uniquement le paramètre pour l'utilisateur actuel.

    Ouvrez de nouveau la boîte de dialogue Ajouter une référence.Les assemblys doivent apparaître sous l'onglet .NET.Si ce n'est pas le cas, vérifiez que les assemblys se trouvent dans le répertoire AssemblyLocation spécifié, redémarrez Visual Studio, puis réessayez.

Pour ajouter une référence en Visual Basic

  1. Dans l'Explorateur de solutions, double-cliquez sur le nœud My Project du projet.

  2. Dans le Concepteur de projets, cliquez sur l'onglet Références.

  3. Cliquez sur le bouton Ajouter pour ouvrir la boîte de dialogue Ajouter une référence.

  4. Dans la boîte de dialogue Ajouter une référence, sélectionnez l'onglet correspondant au type de composant à référencer.

  5. Sélectionnez les composants à référencer, puis cliquez sur OK.

    ConseilConseil

    Vous pouvez sélectionner plusieurs composants en maintenant la touche CTRL enfoncée, à condition les composants se trouvent tous sur le même onglet.

Pour ajouter une référence en Visual C#

  1. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nœud du projet, puis cliquez sur Ajouter une référence.

  2. Dans la boîte de dialogue Ajouter une référence, sélectionnez l'onglet correspondant au type de composant à référencer.

  3. Sélectionnez les composants à référencer, puis cliquez sur OK.

    ConseilConseil

    Vous pouvez sélectionner plusieurs composants en maintenant la touche CTRL enfoncée, à condition les composants se trouvent tous sur le même onglet.

Pour supprimer une référence en Visual Basic

  1. Dans l'Explorateur de solutions, double-cliquez sur le nœud My Project du projet.

  2. Dans le Concepteur de projets, cliquez sur l'onglet Références.

  3. Dans la liste Références, sélectionnez la référence que vous souhaitez supprimer.

  4. Cliquez sur le bouton Supprimer.

    ConseilConseil

    Vous pouvez également vérifier si votre projet contient des références inutilisées et les supprimer toutes à la fois.Pour plus d'informations, consultez How to: Remove Unused References (Visual Basic).

Pour supprimer une référence en Visual C#

  1. Dans l'Explorateur de solutions, ouvrez le nœud Références du nœud du projet.

  2. Cliquez avec le bouton droit sur une référence et cliquez sur Supprimer.

Voir aussi

Tâches

Dépannage de références rompues

Comment : ajouter ou supprimer des espaces de noms importés (Visual Basic)

Référence

Page Application, Concepteur de projets (C#)

Paramètres avancés du compilateur, boîte de dialogue (Visual Basic)

Concepts

Gestion des références de projet

Comment : ajouter ou supprimer des références à l'aide du gestionnaire de références

Gestion des références de projet

Vue d'ensemble du multi-ciblage Visual Studio

Dépannage des erreurs de ciblage du .NET Framework

Autres ressources

Détermination d'une version ou d'un profil spécifique du .NET Framework