Partager via

Comment : ajouter ou supprimer des références dans Visual Studio (Visual Basic)

  • Article

Mise à jour : novembre 2007

Remarque :

La procédure de définition du chemin de référence est légèrement différente pour les projets Visual C#. Dans un projet Visual Basic, cliquez sur le bouton Chemins d'accès des références pour afficher la boîte de dialogue Ajouter une référence. Dans un projet Visual C#, utilisez Chemins d'accès des références, page du Concepteur de projets (C#) du Concepteur de projets. Pour plus d'informations, consultez Comment : définir le chemin d'accès de référence (C#).

Pour utiliser un composant dans votre application, vous devez commencer par ajouter une référence à ce composant. Visual Studio fournit cinq options dans la Ajouter une référence, boîte de dialogue:

  • .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.

La boîte de dialogue Ajouter une référence répertorie seulement les assemblys du dossier Public Assemblies (Program Files\Microsoft Visual Studio 9.0\Common7\IDE\Public Assemblies). Vous pouvez copier vos propres assemblys dans le dossier Public Assemblies ou naviguez directement jusqu'à eux. Notez que vous ne pouvez pas ajouter de références depuis le GAC (Global Assembly Cache), car il fait strictement partie de l'environnement d'exécution.

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.

Si vous déployez ou copiez une application qui contient une référence à un composant personnalisé qui est enregistré dans le GAC, le composant ne sera pas déployé ou copié avec l'application, quel que soit le paramètre Copy Local. Pour plus d'informations, consultez Références de projet.

É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.

Si vous souhaitez ajouter une référence à une DLL COM enregistrée qui contient un manifeste interne, assurez-vous que vous annulez d'abord l'enregistrement 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 Comment : ajouter et supprimer des références Web.

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 du projet actif (vous pouvez rechercher ces assemblys à l'aide de l'onglet Parcourir).

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

    • Le dossier Public Assemblies : Program Files\Microsoft Visual Studio 9.0\Common7\IDE\Public Assemblies ; (vous pouvez rechercher ces assemblys sous l'onglet .NET).

  • Définissez un chemin d'accès de référence au répertoire qui contient l'assembly à l'aide de Chemins d'accès des références, boîte de dialogue (Visual Basic) ou 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 :

    Ajoutez une des clés de Registre suivantes, où <EmplacementAssembly> est le répertoire des assemblys que vous souhaitez afficher dans la boîte de dialogue Ajouter une référence, par exemple, C:\MesAssemblys.

    [HKEY_CURRENT_USER\SOFTWARE\Microsoft\.NETFramework\<version>\AssemblyFoldersEx\MesAssemblys]@="<EmplacementAssembly>"

    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\<version>\AssemblyFoldersEx\MesAssemblys]@="<EmplacementAssembly>"

    Remarque :

    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.

    Appelez encore la boîte de dialogue Ajouter une référence ; les assemblys doivent apparaître sous l'onglet .NET. Dans le cas contraire, assurez-vous que les assemblys se trouvent dans le répertoire <EmplacementAssembly> spécifié, redémarrez Visual Studio et essayez à nouveau.

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.

    Conseil :

    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.

    Conseil :

    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.

    Conseil :

    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 Comment : supprimer les références inutilisées (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.

    Conseil :

    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 Comment : supprimer les références inutilisées (Visual Basic).

Pour définir un chemin d'accès de 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 Chemins d'accès des références.

  4. Dans la boîte de dialogue Chemins d'accès des références, dans le champ Dossier, entrez le chemin d'accès complet au dossier contenant les composants.

  5. Cliquez sur le bouton Ajouter un dossier, puis sur OK.

    Remarque :

    Lorsque vous ouvrez la boîte de dialogue Ajouter une référence, la recherche porte uniquement sur le dossier spécifié et non sur les sous-dossiers. Vous devez ajouter un chemin d'accès distinct pour chaque sous-répertoire à rechercher.

Pour définir un chemin d'accès de 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 Propriétés.

  2. Dans le Concepteur de projets, cliquez sur l'onglet Chemins d'accès des références.

  3. Dans le champ Dossier, entrez le chemin d'accès complet au dossier qui contient les composants.

  4. Cliquez sur le bouton Ajouter un dossier, puis sur OK.

    Remarque :

    Lorsque vous ouvrez la boîte de dialogue Ajouter une référence, la recherche porte uniquement sur le dossier spécifié et non sur les sous-dossiers. Vous devez ajouter un chemin d'accès distinct pour chaque sous-répertoire à rechercher.

Voir aussi

Tâches

Dépannage de références rompues

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

Comment : supprimer les références inutilisées (Visual Basic)

Comment : définir la propriété Copie locale d'une référence

Comment : ajouter de nouveaux éléments de projet

Comment : ajouter et supprimer des références Web

Concepts

Références de projet

Références Web dans Visual Studio

Autres ressources

Gestion des références

Références aux espaces de noms et aux composants