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

Article
03/22/2013

Vous pouvez utiliser la boîte de dialogue Gestionnaire de références pour ajouter et gérer des références aux composants que vous, un Microsoft, ou une autre société sont développés.Si vous développez une application d' Windows Store, votre projet référence automatiquement tous les Windows 8 Kit de développement logiciel et le.NET Framework.Si vous développez un autre type de projet, vous devez ajouter ces références au projet manuellement.

Attention
Vous pouvez ajouter des références à d'autres types de projets à l'aide de la boîte de dialogue Ajouter une référence .Pour plus d'informations, consultez Comment : ajouter ou supprimer des références à l'aide de la boîte de dialogue Ajouter une référence.

Ajout et suppression d'une référence

Pour ajouter une référence dans un projet

Dans la barre de menus, sélectionnez Fichier, Ouvrir.
Accédez à votre solution ou projet.
Dans Explorateur de solutions, ouvrez le menu contextuel du nœud références, puis choisissez Ajouter une référence.
Dans la boîte de dialogue Gestionnaire de références, spécifiez les références pour ajouter, puis choisissez le bouton OK .

Pour supprimer une référence, ouvrez le menu contextuel, puis choisissez Supprimer.

Pour ajouter une référence dans le projet c++

Dans la barre de menus, sélectionnez Fichier, Ouvrir.
Accédez à votre solution ou projet.
Dans Explorateur de solutions, ouvrez le menu contextuel du nœud de projet, puis choisissez Références.
Dans la boîte de dialogue Pages de propriétés, choisissez le bouton Ajouter une nouvelle référence .
Dans la boîte de dialogue Ajouter une référence, spécifiez les références pour ajouter, puis choisissez le bouton OK .

Pour supprimer une référence, ouvrez le menu contextuel, puis choisissez Supprimer.

Gestionnaire de références ouvre et répertorie les références disponibles par le groupe.Le type de projet détermine les groupes suivants s'affichent :

Assemblys, avec les sous-groupes d'infrastructure et d'extensions.
Solution, avec le sous-groupe de projets.
Fenêtres, avec les sous-groupes principale et d'extensions.Vous pouvez explorer les références dans le Kit de développement logiciel ou l'extension Kit de développement logiciel à l'aide Explorateur d'objets.
Recherchez, avec le sous-groupe récent.

Onglet des assemblys

L'onglet de Assemblys répertorie tous les assemblys.NET Framework disponibles pour référencer.L'onglet de Assemblys ne présente aucun assembly du Global Assembly Cache (GAC) car les assemblys dans le GAC font partie de l'environnement d'exécution.Si vous déployez ou copiez une application qui contient une référence à un assembly qui est enregistré dans le GAC, l'assembly n'est pas déployé ou n'est pas copié avec l'application, quel que soit le paramètre copie locale.Pour plus d'informations, consultez Références de projet.

Lorsque vous ajoutez manuellement une référence aux espaces de noms l'un des EnvDTE (EnvDTE et EnvDTE80, EnvDTE90, EnvDTE90a, ou EnvDTE100), affectez à la propriété d'incorporer les Types de référence False dans la fenêtre Propriétés.La définition de cette propriété la valeur true peut provoquer des problèmes de génération en raison de certaines propriétés EnvDTE qui ne peuvent pas être incorporées.

Tous les projets de bureau contiennent une référence implicite à mscorlib.les projets d'Visual Basic contiennent une référence implicite à Microsoft.VisualBasic.Dans Visual Studio 2012, tous les projets contiennent une référence implicite à System.Core, même s'il a supprimé de la liste de références.

Si un type de projet n'est pas prise en charge des blocs, l'onglet ne s'affiche pas dans la boîte de dialogue Gestionnaire de références .

L'onglet des assemblys se compose de deux Sub- onglets :

Listes-cadres tous les assemblys constituant le Framework cible.
- Les assemblys sont publiés dans l'infrastructure complète et sont énumérés dans la liste-cadre lorsque votre projet cible un profil du Framework cible.Les assemblys sont publiés gris pour les différencier des assemblys qui existent dans le profil du Framework cible du projet.Par exemple, si un projet cible le client.NET Framework 4, la liste-cadre affiche les assemblys publiés .NET Framework 4.Lorsqu'un utilisateur ajoute un assembly publié, est averti l'utilisateur que, lorsque la boîte de dialogue Gestionnaire de références fermeture, le projet sera reciblé à .NET Framework 4 et l'assembly publié est ajouté.
- Les projets pour les applications d' Windows Store contiennent des références à tous les assemblys dans .NET pour les applications du Windows Store ciblé par défaut sur la création de projet.Dans les projets managés, un nœud en lecture seule sous le dossier references dans Explorateur de solutions indique la référence à l'infrastructure complète.Par conséquent, l'onglet du .NET framework n'énumèrera pas les assemblys l'un des de l'infrastructure et n'affiche pas à la place le message suivant : « Tous les assemblys d'infrastructure sont déjà référencés.Veuillez utiliser l'Explorateur d'objets pour explorer les références dans l'infrastructure. » Pour les projets de bureau, l'onglet d'infrastructure énumère les assemblys du Framework cible, et l'utilisateur doit ajouter les références que l'application requiert.

Les extensions répertorie tous les assemblys que les constructeurs externes des composants et des contrôles ont développé pour étendre le Framework cible.Selon l'objectif de l'application utilisateur, elle peut avoir besoin de ces assemblys.

Les extensions sont réunies en énumérant les assemblys stockés dans les emplacements suivants :

32-bit machine:
HKEY_CURRENT_USER\SOFTWARE\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
64-bit machine:
HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
And older versions of the [Target Framework Identifier]

Par exemple, si un projet cible .NET Framework 4 sur un ordinateur 32 bits, les extensions énumèreront les assemblys qui sont stockées sous Microsoft .NETFramework\\\v4.0\AssemblyFoldersEx \,\\ Microsoft .NETFramework\v3.5 AssemblyFoldersEx\\,\\ Microsoft .NETFramework\v3.0\AssemblyFoldersEx \,\\ Microsoft et .NETFramework\v2.0\AssemblyFoldersEx \.

Onglet COM

L'onglet COM répertorie tous les composants COM qui sont disponibles pour référencer.Si vous souhaitez ajouter une référence à une DLL COM inscrite qui contient un manifeste interne, annulez l'inscription la DLL en premier.Sinon, Visual Studio ajoute la référence d'assembly comme un contrôle ActiveX et non comme DLL native.

Si un type de projet ne prend pas en charge COM, l'onglet ne s'affiche pas dans la boîte de dialogue Gestionnaire de références .

Onglet de solution

L'onglet de solution répertorie tous les projets compatibles dans la solution actuelle, dans le sous-onglet de projets.

Un projet peut référencer un autre projet qui cible une version différente du .NET Framework.Par exemple, vous pouvez créer un projet qui cible .NET Framework 4 mais qui référence un assembly qui est généré pour le.NET Framework 2.Toutefois, le projet.NET Framework 2 ne peut pas référencer un projet d' .NET Framework 4 .Pour plus d'informations, consultez Détermination d'une version ou d'un profil spécifique du .NET Framework.

Un projet qui cible .NET Framework 4 est incompatible avec un projet qui cible .NET Framework 4 Client Profile.

Dans Visual Studio 2012, une référence de fichier au lieu d'une référence de projet est créée si un projet cible .NET Framework 4 et un autre projet cible une version antérieure.

Un projet qui cible .NET pour les applications du Windows Store ne peut pas ajouter une référence de projet à un projet qui cible le .NET Framework et vice versa.

Onglet windows

L'onglet de fenêtre répertorie tous les Kit de développement logiciel qui sont spécifiques aux plateformes sur lesquelles passe de systèmes d'exploitation Windows.

Vous pouvez générer un fichier de WinMD dans Visual Studio de deux façons :

Windows Store projets managés d'application: les projets d'application de Windows Store peut sortir les binaires de WinMD en définissant des propriétés du projet | Type de sortie = fichier de WinMD.Le nom de fichier de WinMD doit être l'espace de noms sur-ensemble de tous les espaces de noms qui existent dans celui-ci.Par exemple, si un projet se compose des espaces de noms A.B et A.B.C, les noms possibles pour son WinMD outputted sont A.winmd et A.B.winmd.Si un utilisateur dispose les propriétés du projet | Nom de l'assembly ou propriétés du projet | La valeur de l'espace de noms qui est disjoignent de l'ensemble des espaces de noms dans le projet ou il ne sont pas d'espace de noms sur-ensemble dans un projet, un avertissement de build est générée : « A.winmd » n'est pas un nom de fichier valide de .winmd pour cet assembly.Tous les types dans un fichier de métadonnées de fenêtres doivent exister dans un sous espace de noms du nom de fichier.Les types qui n'existent pas dans un sous espace de noms du nom de fichier ne pourront pas se trouver au moment de l'exécution.Dans cet assembly, le plus petit espace de noms courant est « CSWSClassLibrary1 ».Une Visual Basic ou un projet Visual c de bureau peut uniquement utiliser WinMDs générés à l'aide de Windows 8 Kit de développement logiciel, appelée la première partie WinMDs, et ne peut pas générer WinMDs.
Windows Store projets natifs d'application: Un fichier de WinMD natifs se compose uniquement des métadonnées.Son implémentation est utilisée dans un fichier DLL séparé.Il peut produire des fichiers natifs en choisissant le modèle de projet DAC (composant d'exécution de fenêtres dans la boîte de dialogue Nouveau projet ou par à partir d'un projet vierge et en modifiant les propriétés du projet pour générer un fichier de WinMD.Si le projet se compose disjoignez les espaces de noms, une erreur de build indique l'utilisateur combiner les espaces de noms ou exécuter l'outil de MSMerge.

L'onglet de fenêtres se compose de deux Sub-onglets.

Principal sous-groupe

Le principal onglet répertorie tous les WinMDs (pour les éléments de WinRT) dans le Kit de développement logiciel pour la version de Windows ciblée.

les projets d'application deWindows Store contiennent des références à tous les WinMDs dans Windows 8 Kit de développement logiciel par défaut sur la création de projet.Dans les projets managés, un nœud en lecture seule sous le dossier references dans Explorateur de solutions indique la référence à Windows 8 entier Kit de développement logiciel.Par conséquent, le principal onglet dans le gestionnaire de référence n'énumèrera pas les assemblys l'un des d' Windows 8 Kit de développement logiciel et n'affiche pas à la place un message : « Le Kit de développement logiciel est déjà référencée.Veuillez utiliser l'Explorateur d'objets pour explorer les références dans le Kit de développement logiciel. »

Dans les projets de bureau le principal onglet ne s'affiche pas par défaut.Vous pouvez ajouter des fenêtres d'opération en ouvrant le menu contextuel du nœud de projet, choisissant Décharger le projet, en ajoutant l'extrait de code suivant, et la ré-ouverture le projet (sous le nœud de projet dans Recharger le projet).Lorsque vous appelez la boîte de dialogue Gestionnaire de références, le principal onglet s'affiche.

  <PropertyGroup>
    <TargetPlatformVersion>8.0</TargetPlatformVersion>
  </PropertyGroup>

Veillez à vérifier la zone de windows sur cette table.Vous devez ensuite utiliser des éléments de WinRT.

Sous-groupe d'extensions

Les extensions répertorie l'utilisateur Kit de développement logiciel qui étendent la plateforme ciblée Windows.Cet onglet s'affiche pour les projets d'application de Windows Store uniquement.Les projets de bureau n'affiche pas cet onglet car ils peuvent utiliser uniquement les fichiers de la première partie .winmd.

Un Kit de développement logiciel est une collection de fichiers que Visual Studio traite comme un composant unique.Dans l'onglet d'extensions, les Kit de développement logiciel qui s'appliquent au projet à partir duquel la boîte de dialogue Gestionnaire de références a été appelée apparaissent comme entrées uniques.Une fois ajouté à un projet, tout le contenu du Kit de développement logiciel est consommé par Visual Studio tels que l'utilisateur n'a pas besoin de prendre une autre mesure de tirer parti le contenu du Kit de développement SDK dans Intellisense, la boîte à outils, les concepteurs, l'Explorateur d'objets, la génération, le déploiement, le débogage, et l'empaquetage.Pour plus d'informations sur l'affichage du Kit de développement SDK dans les extensions tabulez, consultez le Comment : créer un Kit de développement logiciel (SDK).

[!REMARQUE]

Si le projet référence un Kit de développement logiciel qui dépend d'un autre Kit de développement logiciel, Visual Studio ne consommeront pas le deuxième Kit de développement logiciel à moins que l'utilisateur ajoute manuellement une référence au deuxième Kit de développement logiciel.Lorsqu'un utilisateur sélectionne un Kit de développement logiciel sous l'onglet de Extensions, la boîte de dialogue Gestionnaire de références aide l'utilisateur à identifier les dépendances du Kit de développement logiciel en répertoriant non seulement le nom et la version du Kit de développement logiciel mais également le nom de toutes les dépendances du Kit de développement SDK dans le volet d'informations.Si un utilisateur ne remarque pas les dépendances et n'ajoute pas uniquement ce Kit de développement logiciel, MSBuild invite l'utilisateur à ajouter des dépendances.

Si un type de projet ne prend pas Extensions, l'onglet ne s'affiche pas dans la boîte de dialogue Gestionnaire de références .

Bouton Parcourir

Vous pouvez utiliser le bouton Parcourir pour rechercher un composant dans le système de fichiers.

Un projet peut référencer un composant qui cible une version différente du .NET Framework.Par exemple, vous pouvez créer une application qui cible .NET Framework 4 Client Profile, qui référence un composant qui cible .NET Framework 2.Pour plus d'informations, consultez Détermination d'une version ou d'un profil spécifique du .NET Framework.

Vous devez éviter d'ajouter des références de fichier aux sorties d'un autre projet de la même solution, car cette tactique peut provoquer des erreurs de compilation.À la place, utilisez l'onglet de Solution de la boîte de dialogue Gestionnaire de références pour créer des références entre projets.Cette tactique 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.

Vous ne pouvez pas naviguer jusqu'au Kit de développement logiciel et l'ajouter à votre projet.Vous pouvez uniquement accéder à un fichier (par exemple, un assembly ou un .winmd) et l'ajouter à votre projet.

En faire une référence de fichier à un WinMD, la disposition souhaitée est que [nom du fichier les .winmd], [nom du fichier] tous les fichiers .dll, et [nom du fichier] de .pri sont placés à côté l'un de l'autre.Si vous référencez un WinMD dans les scénarios suivants, un ensemble incomplet de fichiers est copié dans le répertoire de sortie du projet et, par conséquent, la génération et les échecs de runtime se produisent.

Composant natif: un projet natif crée un WinMD pour chacun disjoignent l'ensemble des espaces de noms et d'une DLL qui inclut l'implémentation.Le WinMDs aura des noms disparates.Lorsque vous référencez ce fichier de composant natif, MSBuild ne reconnaît pas que le WinMDs différemment nommé font un composant.Par conséquent, seule [nom du fichier] .dll de manière identique nommé et [nom du fichier] .winmd sera copié, et les erreurs d'exécution se produisent.Pour contourner ce problème, créez une extension Kit de développement logiciel.Pour plus d'informations, consultez Comment : créer un Kit de développement logiciel (SDK).
Utiliser des contrôles: au minimum, un contrôle XAML se compose d'un [nom du fichier] .winmd, [nom du fichier] .dll, [nom du fichier] .pri, [xamlname] .xaml, et [imagename] .jpg.Lorsque le projet est généré, les fichiers de ressources associés à la référence de fichier ne obtiendront pas copiés dans le répertoire de sortie du projet, et uniquement [nom du fichier], .winmd [nom du fichier] .dll et [nom du fichier] .pri seront copiés.Une erreur de build est stockée pour informer l'utilisateur que les ressources [xamlname].xaml et [imagename].jpg sont absentes.Pour réussir, l'utilisateur doit copier manuellement les fichiers de ressources dans le dossier de sortie de projet pour la génération et le débogage/runtime.Pour contourner ce problème, créez une extension Kit de développement logiciel en suivant les étapes de Comment : créer un Kit de développement logiciel (SDK) ou modifiez le fichier projet pour ajouter la propriété suivante :
```
<PropertyGroup>
<GenerateLibraryOutput>True</GenerateLibraryOutput>
</PropertyGroup>
```
[!REMARQUE]

Si vous ajoutez la propriété, la génération peut s'exécuter plus lentement.

Recent

Les assemblys, COM, fenêtres et, parcourir chaque charge un onglet récent, qui énumère la liste des composants qui ont été récemment ajoutés aux projets.

Rechercher

La barre de recherche dans la boîte de dialogue Gestionnaire de références fonctionne sur l'onglet qui a le focus.Par exemple, si l'utilisateur entre « système » dans la barre de recherche lorsque l'onglet de solution est au focus, la recherche ne retournent pas de résultats à moins que la solution est constituée d'un nom de projet qui contient « système ».

Voir aussi

Tâches

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

Concepts

Gestion des références de projet

Partager via