Références de projet
Mise à jour : novembre 2007
Si vous souhaitez écrire du code pour un composant externe, veillez à ce que votre projet contienne une référence à ce composant. Il est possible de créer une référence à l'aide des types de composants suivants :
des assemblys ou bibliothèques de classes .NET Framework ;
des composants COM ;
d'autres assemblys ou bibliothèques de classes de projets de la même solution ;
des services Web XML.
Pour plus d'informations sur les références à un service Web XML, consultez Références Web dans Visual Studio.
.gif "Remarque pour Visual Basic") Remarque pour Visual Basic : |
|---|
Les références de projet ne sont pas gérées dans Visual Studio de la même manière que dans Visual Basic 6.0. Pour plus d'informations, consultez Gestion de projets pour les utilisateurs de Visual Basic 6.0. |
Ajout de références au moment du design
Utilisez la Ajouter une référence, boîte de dialogue pour ajouter des références aux composants au moment du design.
La boîte de dialogue Ajouter une référence répertorie les assemblys dans les emplacements suivants :
Le dossier Public Assemblies (Program Files\Microsoft Visual Studio 9.0\Common7\IDE\Public Assemblies).
Si vous copiez d'autres assemblys dans le dossier Public Assemblies, ils apparaissent dans la liste de la boîte de dialogue Ajouter une référence.
Les dossiers que vous avez spécifiés en définissant les chemins d'accès des références.
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#).
Vous pouvez également utiliser la boîte de dialogue Ajouter une référence pour naviguer jusqu'aux assemblys non répertoriés. Vous ne pouvez pas ajouter de références depuis le Global Assembly Cache (GAC), car il fait strictement partie de l'environnement d'exécution.
Lorsque vous référencez un assembly dans votre projet, Visual Studio commence la recherche par les 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).
Les dossiers que vous avez spécifiés en définissant les chemins d'accès des références. (Vous pouvez définir des chemins d'accès des références à l'aide de Chemins d'accès des références, boîte de dialogue (Visual Basic) ou de Chemins d'accès des références, page du Concepteur de projets (C#).)
Pour plus d'informations sur l'ajout de références au moment de la conception, consultez Comment : ajouter ou supprimer des références dans Visual Studio (Visual Basic).
Références aux composants partagés à l'exécution
Au moment de l'exécution, les composants doivent se trouver dans le chemin de sortie du projet ou dans le Global Assembly Cache (GAC). Si le projet contient une référence à un objet qui ne se trouve pas à l'un de ces emplacements, la référence doit être copiée dans le chemin de sortie du projet lorsque celui-ci est généré. La propriété CopyLocal indique s'il est nécessaire d'effectuer la copie. Si la valeur est True, la référence est copiée vers le répertoire de projet lorsque vous générez le projet. Si la valeur est False, la référence n'est pas copiée.
Si vous déployez une application qui contient une référence à un composant personnalisé qui est enregistré dans le GAC, le composant ne sera pas déployé avec l'application, quel que soit paramètre CopyLocal. Dans les versions antérieures de Visual Studio, vous pouviez affecter une référence à la propriété CopyLocal afin de garantir que l'assembly était déployé. À présent, vous devez ajouter manuellement l'assembly au dossier \Bin. Cela permet de placer tout le code personnalisé sous surveillance, en réduisant le risque de publier du code personnalisé avec lequel vous n'êtes pas familiarisé.
Par défaut, la propriété CopyLocal a la valeur False si l'assembly ou le composant se trouve dans le Global Assembly Cache (GAC) ou s'il s'agit d'un composant .NET Framework. Sinon, sa valeur est True. La valeur est toujours True pour les références entre projets.
Références entre projets et Références de fichiers
Les références de fichiers sont des références directes aux assemblys ; vous les créez à l'aide de l'onglet Parcourir de la boîte de dialogue Ajouter une référence. Les références entre projets sont des références aux projets qui contiennent des assemblys ; vous les créez à l'aide de l'onglet Projet de la boîte de dialogue Ajouter une référence.
Une référence entre projets présente l'avantage de créer une dépendance entre les projets dans le système de génération, de telle sorte que le projet dépendant sera généré s'il a été modifié depuis la dernière génération du projet de référence. Une référence de fichier ne crée pas de dépendance de génération, et il est donc possible de générer le projet de référence sans générer le projet dépendant. Une telle référence peut par conséquent devenir obsolète (un projet peut référencer une version générée antérieurement de l'autre projet). Cette situation peut nécessiter la présence de plusieurs versions d'une même DLL dans le répertoire bin, ce qui n'est pas possible, d'où l'affichage de ce message d'erreur. Lorsque ce conflit se produit, le message Avertissement : impossible de copier la dépendance 'fichier' du projet 'projet' dans le répertoire d'exécution, car elle remplacerait la référence 'fichier'. s'affiche.
É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 au sein de la même solution. 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 et Comment : créer et supprimer les dépendances d'un projet.
Références Web
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.
Voir aussi
Tâches
Dépannage de références rompues
Comment : ajouter ou supprimer des références dans Visual Studio (Visual Basic)
Référence
Ajouter une référence, boîte de dialogue