Gérer les références dans un projet

2025-06-12

Avant d’écrire du code sur un composant externe ou un service connecté, votre projet doit d’abord contenir une référence à celui-ci. Une référence est essentiellement une entrée dans un fichier projet qui contient les informations dont Visual Studio a besoin pour localiser le composant ou le service.

La façon dont vous ajoutez une référence dépend du type de projet pour le code sur lequel vous travaillez :

Si vous voyez un nœud de Dépendances dans Explorateur de solutions, vous pouvez utiliser le menu contextuel du clic droit pour sélectionner Ajouter une référence de projet.

Vous pouvez également cliquer avec le bouton droit sur le nœud de projet , puis sélectionner Ajouter>référence de projet.
Si vous voyez un nœud de Références dans Explorateur de solutions, vous pouvez utiliser le menu contextuel du clic droit pour sélectionner Ajouter une référence.

Vous pouvez également cliquer avec le bouton droit sur le nœud de projet et sélectionner Ajouter>référence.

Pour plus d’informations, consultez Guide pratique pour ajouter ou supprimer des références.

Vous pouvez ajouter une référence aux types de composants et de services suivants :

Bibliothèques de classes ou assemblages .NET
Applications UWP
Composants COM
Autres bibliothèques de classes ou assemblies de projets dans la même solution
Projets partagés
Services web XML

Références d’application UWP

La plateforme Windows universelle (UWP) fournit une plateforme d’application commune pour chaque appareil exécutant Windows. Pour savoir comment créer une application UWP, consultez Tutoriel : Créer votre première application de plateforme Windows universelle dans Visual Studio avec XAML et C#.

Références de projet

Les projets de plateforme Windows universelle (UWP) peuvent créer des références à d’autres projets UWP dans la solution, ou à des projets ou binaires Windows 8.1, à condition que ces projets n’utilisent pas d’API qui ont été déconseillées dans Windows 10 et versions ultérieures. Pour plus d’informations, consultez Passer de Windows Runtime 8 à UWP.

Si vous choisissez de recibler les projets Windows 8.1 vers Windows 10 et des versions ultérieures, consultez Déplacer, migrer et mettre à jour des projets Visual Studio.

Conseil

Pour plus d’informations sur la création et la génération d’une application UWP pour Windows 10 et Windows 11, consultez Choisir une version UWP.

Références des SDK d'extension

Les applications de plateforme Windows universelle (UWP) Visual Basic, C#, C++ et JavaScript peuvent référencer les kits SDK d’extension qui ciblent Windows 8.1, tant que ces KITS SDK d’extension n’utilisent pas d’API qui ont été déconseillées dans Windows 10 et versions ultérieures. Consultez le site fournisseur du Kit de développement logiciel (SDK) d’extension pour savoir s’il peut être référencé par les applications UWP.

Si vous déterminez que le SDK d’extension référencé par votre application n’est pas pris en charge, vous devez effectuer les étapes suivantes :

Examinez le nom du projet à l’origine de l’erreur. La plateforme que votre projet cible est notée entre parenthèses en regard du nom du projet. Par exemple, MyProjectName (Windows 8.1) signifie que votre projet MyProjectName cible la version de plateforme Windows 8.1.
Accédez au site du fournisseur propriétaire du Kit de développement logiciel (SDK) d’extension non pris en charge et installez la version du Kit de développement logiciel (SDK) d’extension avec les dépendances compatibles avec la version de la plateforme que votre projet cible.

Remarque

Une façon de déterminer si un SDK d’extension a des dépendances sur d’autres SDKs d’extension est de consulter le Gestionnaire de références. Redémarrez Visual Studio, créez un projet d’application UWP C#, puis cliquez avec le bouton droit sur le projet, puis sélectionnez Ajouter une référence. Accédez à l’onglet Windows, puis Extensions sous-onglet, puis sélectionnez le Kit de développement logiciel (SDK) d’extension. Examinez le volet droit dans le gestionnaire de références . S’il a des dépendances, ils sont répertoriés ici.

Important

Si votre projet cible spécifiquement Windows 10 et que le KIT de développement logiciel (SDK) d’extension installé à l’étape précédente a une dépendance sur le package d’exécution Microsoft Visual C++, la version du package Runtime Microsoft Visual C++ compatible avec Windows 10 est v14.0 et installée avec Visual Studio.
Si le SDK d’extension que vous avez installé à l’étape précédente a des dépendances sur d’autres kits SDK d’extension, accédez aux sites des fournisseurs qui possèdent les dépendances, puis installez les versions de ces dépendances compatibles avec la version de la plateforme que votre projet cible.
Redémarrez Visual Studio et ouvrez votre application.
Cliquez avec le bouton droit sur le nœud Références ou Dépendances dans le projet à l’origine de l’erreur, puis sélectionnez Ajouter une référence.
Sélectionnez l’onglet Windows, puis le sous-onglet Extensions, décochez les cases des anciens kits SDK d’extensions, puis cochez celles pour les nouveaux kits SDK d’extensions. Sélectionnez OK.

Ajouter une référence au moment du design

Lorsque vous effectuez une référence à un assembly dans votre projet, Visual Studio recherche l’assembly dans les emplacements suivants :

Répertoire du projet actuel. (Vous pouvez trouver ces assemblages à l’aide de l’onglet Parcourir.)
Autres répertoires de projet dans la même solution. (Vous pouvez trouver ces assemblages sous l’onglet Projets.)

Remarque

Tous les projets contiennent une référence implicite à mscorlib.
Tous les projets contiennent une référence implicite à System.Core, même si System.Core est supprimé de la liste des références.
Les projets Visual Basic contiennent une référence implicite à Microsoft.VisualBasic.

Références aux composants partagés au moment de 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 n’est pas dans l’un de ces emplacements, vous devez copier la référence au chemin de sortie du projet lorsque vous générez le projet. La propriété CopyLocal indique si cette copie doit être effectuée. Si la valeur est True, la référence est copiée dans le répertoire du 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é inscrit dans le GAC, le composant ne sera pas déployé avec l’application, quel que soit le paramètre CopyLocal. Dans les versions antérieures de Visual Studio, vous pouvez définir la propriété CopyLocal sur une référence pour vous assurer que l’assembly a été déployé. À présent, vous devez ajouter manuellement l’assembly au dossier \Bin. Cette action place tout le code personnalisé sous examen, réduisant ainsi le risque de publication de code personnalisé avec lequel vous n’êtes pas familiarisé.

Par défaut, la propriété CopyLocal est définie sur False si l’assembly ou le composant se trouve dans le Global Assembly Cache ou est un composant framework. Sinon, la valeur est définie sur True. Les références de projet à projet sont toujours définies sur True.

Référencer un projet ou un assembly qui cible une autre version de .NET

Vous pouvez créer des applications qui référencent des projets ou des assemblys qui ciblent une autre version du .NET. Par exemple, vous pouvez créer une application qui cible .NET Framework 4.6, qui fait référence à un assembly qui cible .NET Framework 4.5. Si vous créez un projet qui cible une version antérieure de .NET, vous ne pouvez pas définir de référence dans ce projet sur un projet ou un assembly qui cible une version plus récente.

Pour plus d’informations, consultez Vue d’ensemble du ciblage d’infrastructure.

Références de projet à projet

Les références de projet en projet sont des références à des projets qui contiennent des assemblages. Vous ajoutez des références de projet à l'aide de l'onglet Projects de la boîte de dialogue du gestionnaire de références. Visual Studio peut trouver un assembly lorsqu’un chemin d’accès au projet est donné.

Lorsque vous disposez d’un projet qui produit un assembly, vous devez référencer le projet et ne pas utiliser de référence de fichier. L’avantage d’une référence de projet à projet est qu’elle crée une dépendance entre les projets du système de génération. Le projet dépendant est construit s'il a changé depuis la dernière construction du projet de référence. Une référence de fichier ne crée pas de dépendance de build. Il est donc possible de générer le projet de référencement sans générer le projet dépendant, et la référence peut devenir obsolète. (Autrement dit, le projet peut référencer une version créée précédemment du projet.) Cela peut entraîner la nécessité de plusieurs versions d’une DLL unique dans le répertoire bin, ce qui n’est pas possible. Lorsque ce conflit se produit, un message s’affiche, tel que « Avertissement : le fichier de dépendance dans le projet « projet » ne peut pas être copié dans le répertoire d’exécution, car il remplacerait la référence « fichier ». Pour plus d’informations, consultez Résoudre les problèmes de références rompues et Guide pratique pour créer et supprimer des dépendances de projet.

Remarque

Une référence de fichier au lieu d’une référence de projet à projet est créée si la version cible du .NET Framework d’un projet est la version 4.5 et que la version cible de l’autre projet est la version 2, 3, 3.5 ou 4.0.

Références de projet partagés

Contrairement à la plupart des autres types de projets, un projet partagé n’a pas de sortie binaire. Au lieu de cela, le code est compilé dans chaque projet qui le référence. Les projets partagés vous permettent d’écrire du code commun référencé par de nombreux projets d’application différents. Le code est compilé dans le cadre de chaque projet de référencement et peut inclure des directives du compilateur pour aider à incorporer des fonctionnalités spécifiques à la plateforme dans la base de code partagé. Ajoutez une référence à un projet partagé sous l’onglet Projets partagés de la boîte de dialogue Gestionnaire de références.

Références de fichiers

Les références de fichier sont des références directes aux assemblys en dehors du contexte d’un projet Visual Studio. Vous les créez à l’aide de l’onglet Parcourir de la boîte de dialogue Gestionnaire de références. Utilisez une référence de fichier lorsque vous n'avez qu'un assemblage ou un composant, et non le projet qui le crée en tant que sortie.