Interface utilisateur du Gestionnaire de Package NuGetNuGet Package Manager UI

Le Gestionnaire de Package NuGet UI dans Visual Studio sur Windows vous permet facilement installer, désinstaller et mettre à jour les packages NuGet dans les projets et solutions.The NuGet Package Manager UI in Visual Studio on Windows allows you to easily install, uninstall, and update NuGet packages in projects and solutions. Pour une expérience dans Visual Studio pour Mac, consultez , y compris un package NuGet dans votre projet.For the experience in Visual Studio for Mac, see Including a NuGet package in your project. Le Gestionnaire de Package UI n’est pas inclus avec Visual Studio Code.The Package Manager UI is not included with Visual Studio Code.

Dans cette rubrique :In this topic:

Notes

Si vous êtes pas le Gestionnaire de Package NuGet dans Visual Studio 2015, consultez Outils > Extensions et mises à jour... et recherchez le Gestionnaire de Package NuGet extension.If you're missing the NuGet Package Manager in Visual Studio 2015, check Tools > Extensions and Updates... and search for the NuGet Package Manager extension. Si vous ne parvenez pas à utiliser le programme d’installation des extensions dans Visual Studio, téléchargez l’extension directement à partir de https://dist.nuget.org/index.html .If you're unable to use the extensions installer in Visual Studio, download the extension directly from https://dist.nuget.org/index.html.

Visual Studio 2017, NuGet et le Gestionnaire de Package NuGet sont installées automatiquement avec n’importe quelle. Charges de travail liées NET.In Visual Studio 2017, NuGet and the NuGet Package Manager are automatically installed with any .NET-related workloads. Installer individuellement en sélectionnant le composants individuels > Outils de Code > Gestionnaire de package NuGet option dans le programme d’installation de Visual Studio 2017.Install it individually by selecting the Individual components > Code tools > NuGet package manager option in the Visual Studio 2017 installer.

Recherche et installation d’un packageFinding and installing a package

  1. Dans l’Explorateur de solutions, avec le bouton droit soit références ou un projet, puis sélectionnez gérer les Packages NuGet... .In Solution Explorer, right-click either References or a project and select Manage NuGet Packages....

    Gérer l’option de menu de Packages NuGet

  2. Le Parcourir onglet affiche les packages par popularité à partir de la source actuellement sélectionnée (consultez sources de packages).The Browse tab displays packages by popularity from the currently selected source (see package sources). Recherchez un package spécifique à l’aide de la zone de recherche dans la coin supérieur gauche.Search for a specific package using the search box on the upper left. Sélectionner un package à partir de la liste pour afficher ses informations, ce qui permet également la installer bouton avec une liste déroulante Sélection de la version.Select a package from the list to display its information, which also enables the Install button along with a version-selection drop-down.

    Gérer l’onglet Parcourir de boîte de dialogue de Packages NuGet

  3. Sélectionnez la version souhaitée dans la liste déroulante et sélectionnez installer.Select the desired version from the drop-down and select Install. Visual Studio installe le package et ses dépendances dans le projet.Visual Studio installs the package and its dependencies into the project. Vous pouvez être invité à accepter les termes du contrat de licence.You may be asked to accept license terms. Lors de l’installation est terminée, les packages ajoutés s’affichent sur le installé onglet. Les packages sont également répertoriés dans le références nœud de l’Explorateur de solutions, indiquant que vous puissiez y faire référence dans le projet avec using instructions.When installation is complete, the added packages appear on the Installed tab. Packages are also listed in the References node of Solution Explorer, indicating that you can refer to them in the project with using statements.

    Références dans l’Explorateur de solutions

Conseil

Pour inclure les versions préliminaires dans la recherche et de proposer des versions préliminaires dans la version de liste déroulante, sélectionnez le inclure la version préliminaire option.To include prerelease versions in the search, and to make prerelease versions available in the version drop-down, select the Include prerelease option.

Désinstaller un packageUninstalling a package

  1. Dans l’Explorateur de solutions, avec le bouton droit soit références ou le projet de votre choix, puis sélectionnez gérer les Packages NuGet... .In Solution Explorer, right-click either References or the desired project, and select Manage NuGet Packages....

  2. Sélectionnez le installé onglet.Select the Installed tab.

  3. Sélectionnez le package à désinstaller (à l’aide de la recherche pour filtrer la liste si nécessaire), puis sélectionnez désinstallation.Select the package to uninstall (using search to filter the list if necessary) and select Uninstall.

    Désinstaller un package

  4. Notez que le inclure la version préliminaire et source du Package contrôles n’ont aucun effet lors de la désinstallation des packages.Note that the Include prerelease and Package source controls have no effect when uninstalling packages.

Mettre à jour un packageUpdating a package

  1. Dans l’Explorateur de solutions, avec le bouton droit soit références ou le projet de votre choix, puis sélectionnez gérer les Packages NuGet... . (Dans les projets de site web, cliquez sur le Bin dossier.)In Solution Explorer, right-click either References or the desired project, and select Manage NuGet Packages.... (In web site projects, right-click the Bin folder.)

  2. Sélectionnez le mises à jour onglet pour afficher les packages qui ont des mises à jour disponibles à partir des sources de package sélectionné.Select the Updates tab to see packages that have available updates from the selected package sources. Sélectionnez inclure la version préliminaire à inclure des packages de version préliminaire dans la liste mise à jour.Select Include prerelease to include prerelease packages in the update list.

  3. Sélectionnez le package à mettre à jour, sélectionnez la version souhaitée dans la liste déroulante à droite, puis mettre à jour.Select the package to update, select the desired version from the drop-down on the right, and select Update.

    Mettre à jour un package

  4. Pour certains packages, les mise à jour bouton est désactivé et un message s’affiche indiquant qu’il est « implicitement référencé par un SDK » (ou « AutoReferenced »).For some packages, the Update button is disabled and a message appears saying that it's "Implicitly referenced by an SDK" (or "AutoReferenced"). Ce message indique que le package fait partie d’un framework plus grand ou le Kit de développement logiciel et ne doit-elle pas être mis à jour indépendamment.This message indicates that the package is part of a larger framework or SDK and should not be updated independently. (Ces packages sont signalés en interne par <IsImplicitlyDefined>True</IsImplicitlyDefined>.) Par exemple, Microsoft.NETCore.App fait partie du SDK .NET Core, et la version du package n’est pas identique à la version de l’infrastructure du runtime utilisée par l’application.(Such packages are internally marked with <IsImplicitlyDefined>True</IsImplicitlyDefined>.) For example, Microsoft.NETCore.App is part of the .NET Core SDK, and the package version is not the same as the version of the runtime framework used by the application. Vous devez mettre à jour votre installation de .NET Core pour obtenir de nouvelles versions du runtime ASP.NET Core et .NET Core.You need to update your .NET Core installation to get new versions of the ASP.NET Core and .NET Core runtime. Consultez ce document pour plus d’informations sur les métapackages .NET Core et le contrôle de version.See this document for more details on .NET Core metapackages and versioning. Cela s’applique aux packages couramment utilisées suivantes :This applies to the following commonly used packages:

    • Microsoft.AspNetCore.AllMicrosoft.AspNetCore.All
    • Microsoft.AspNetCore.AppMicrosoft.AspNetCore.App
    • Microsoft.NETCore.AppMicrosoft.NETCore.App
    • NETStandard.LibraryNETStandard.Library

    Exemple de package la mention implicitement références ou AutoReferenced

  5. Pour mettre à jour plusieurs packages vers leurs versions les plus récentes, sélectionnez-les dans la liste, puis sélectionnez le mettre à jour bouton au-dessus de la liste.To update multiple packages to their newest versions, select them in the list and select the Update button above the list.

  6. Vous pouvez également mettre à jour un package individuel à partir de la installé onglet. Dans ce cas, les détails pour le package incluent un sélecteur de version (soumis à la inclure la version préliminaire option) et un mise à jour bouton.You can also update an individual package from the Installed tab. In this case, the details for the package include a version selector (subject to the Include prerelease option) and an Update button.

La gestion des packages pour la solutionManaging packages for the solution

La gestion des packages pour une solution sont un moyen pratique de travailler avec plusieurs projets simultanément.Managing packages for a solution is a convenient means to work with multiple projects simultaneously.

  1. Sélectionnez le Outils > Gestionnaire de Package NuGet > Gérer les Packages NuGet pour la Solution... menu de commande, ou avec le bouton droit de la solution et sélectionnez gérer les Packages NuGet... :Select the Tools > NuGet Package Manager > Manage NuGet Packages for Solution... menu command, or right-click the solution and select Manage NuGet Packages...:

    Gérer les packages NuGet pour la solution

  2. Lors de la gestion des packages pour la solution, l’interface utilisateur vous permet de sélectionner les projets qui sont affectés par les opérations :When managing packages for the solution, the UI lets you select the projects that are affected by the operations:

    Sélecteur de projet lors de la gestion des packages pour la solution

Consolider ongletConsolidate tab

Les développeurs estiment généralement mauvaise pratique pour utiliser les différentes versions du même package NuGet sur différents projets dans la même solution.Developers typically consider it bad practice to use different versions of the same NuGet package across different projects in the same solution. Lorsque vous choisissez de gérer les packages pour une solution, le Gestionnaire de Package UI fournit un consolider onglet sur lequel vous pouvez facilement voir où les packages avec des numéros de version distincts sont utilisés par différents projets dans la solution :When you choose to manage packages for a solution, the Package Manager UI provides a Consolidate tab on which you can easily see where packages with distinct version numbers are used by different projects in the solution:

Onglet consolider de l’interface utilisateur de gestionnaire de package

Dans cet exemple, le projet ClassLibrary1 est à l’aide de EntityFramework 6.2.0, tandis que ConsoleApp1 est à l’aide de EntityFramework 6.1.0.In this example, the ClassLibrary1 project is using EntityFramework 6.2.0, whereas ConsoleApp1 is using EntityFramework 6.1.0. Pour consolider les versions de package, procédez comme suit :To consolidate package versions, do the following:

  • Sélectionnez les projets à mettre à jour dans la liste des projets.Select the projects to update in the project list.
  • Sélectionnez la version à utiliser dans tous ces projets dans le Version contrôle, tel qu’Entity Framework 6.2.0.Select the version to use in all those projects in the Version control, such as EntityFramework 6.2.0.
  • Sélectionnez le installer bouton.Select the Install button.

Le Gestionnaire de Package installe la version du package sélectionné dans tous les projets sélectionnés, après laquelle le package n’apparaît plus dans le consolider onglet.The Package Manager installs the selected package version into all selected projects, after which the package no longer appears on the Consolidate tab.

Sources de packagePackage sources

Pour modifier la source à partir de laquelle Visual Studio obtient les packages, sélectionnez un dans le sélecteur de source :To change the source from which Visual Studio obtains packages, select one from the source selector:

Sélecteur de source de package dans l’interface utilisateur du Gestionnaire de package

Pour gérer les sources de package :To manage package sources:

  1. Sélectionnez le paramètres icône dans le Gestionnaire de Package UI décrites ci-dessous ou utilisez le Outils > Options de commandes et accédez à Gestionnaire de Package NuGet:Select the Settings icon in the Package Manager UI outlined below or use the Tools > Options command and scroll to NuGet Package Manager:

    Icône des paramètres de l’interface utilisateur package manager

  2. Sélectionnez le Sources de Package nœud :Select the Package Sources node:

    Options de Sources de package

  3. Pour ajouter une source, sélectionnez +, modifiez le nom, entrez l’URL ou le chemin d’accès dans le Source contrôler, puis sélectionnez mise à jour.To add a source, select +, edit the name, enter the URL or path in the Source control, and select Update. La source apparaît maintenant dans le sélecteur de liste déroulante.The source now appears in the selector drop-down.

  4. Pour modifier une source de package, sélectionnez-le, apporter des modifications dans le nom et Source cases, puis sélectionnez mise à jour.To change a package source, select it, make edits in the Name and Source boxes, and select Update.

  5. Pour désactiver une source de package, désactivez la case à gauche du nom dans la liste.To disable a package source, clear the box to the left of the name in the list.

  6. Pour supprimer une source de package, sélectionnez-le, puis le X bouton.To remove a package source, select it and then select the X button.

  7. À l’aide de haut et flèche vers le bas les boutons ne changent pas l’ordre de priorité des sources de package.Using the up and down arrow buttons does not change the priority order of the package sources. Visual Studio ignore l’ordre des sources de packages, utilise le package à partir de la première source à répondre aux demandes.Visual Studio ignores the order of package sources, using the package from whichever source is first to respond to requests. Pour plus d’informations, consultez restauration des packages.For more information, see Package restore.

Conseil

Si une source de package s’affiche de nouveau après l’avoir supprimée, devrait être répertoriée dans au niveau de l’ordinateur ou le niveau de l’utilisateur NuGet.Config fichiers.If a package source reappears after deleting it, it may be listed in a computer-level or user-level NuGet.Config files. Consultez du comportement de NuGet configuration pour l’emplacement de ces fichiers, puis supprimer la source en modifiant les fichiers manuellement ou en utilisant le nuget sources commande.See Configuring NuGet behavior for the location of these files, then remove the source by editing the files manually or using the nuget sources command.

Contrôlent les Options du Gestionnaire de packagePackage manager Options control

Lorsqu’un package est sélectionné, le Gestionnaire de Package UI affiche un petit, extensible Options contrôle sous le sélecteur de version (illustré ici à la fois réduit et développé).When a package is selected, the Package Manager UI displays a small, expandable Options control below the version selector (shown here both collapsed and expanded). Notez que, pour un projet, les types, uniquement le afficher la fenêtre d’aperçu option est fournie.Note that for some project types, only the Show preview window option is provided.

Options du Gestionnaire de package

Les sections suivantes décrivent ces options.The following sections explain these options.

Afficher la fenêtre d’aperçuShow preview window

Sélectionné, une fenêtre modale affiche ce qui les dépendances d’un package choisi avant que le package est installé :When selected, a modal window displays which the dependencies of a chosen package before the package is installed:

Boîte de dialogue Aperçu exemple

Installer et mettre à jour des OptionsInstall and Update Options

(Non disponible pour tous les types de projet).(Not available for all project types.)

Comportement de dépendance configure la façon dont NuGet décide quelles versions des packages dépendants à installer :Dependency behavior configures how NuGet decides which versions of dependent packages to install:

  • Ignorer les dépendances ignore l’installation de toutes les dépendances, ce qui interrompt généralement le package en cours d’installation.Ignore dependencies skips installing any dependencies, which typically breaks the package being installed.
  • La plus basse [Default] installe la dépendance avec le numéro de version minimal qui répond aux exigences du package principal choisi.Lowest [Default] installs the dependency with the minimal version number that meets the requirements of the primary chosen package.
  • Correctif logiciel le plus élevé installe la version avec les mêmes numéros de version principale et secondaire, mais le plus grand nombre de correctifs.Highest Patch installs the version with the same major and minor version numbers, but the highest patch number. Par exemple, si version 1.2.2 est spécifiée, la version la plus élevée qui commence par 1.2 sera être installéeFor example, if version 1.2.2 is specified then the highest version that starts with 1.2 will be installed
  • Mineur le plus élevé installe la version avec le même numéro de version principale, mais le numéro mineur le plus élevé et le numéro du correctif.Highest Minor installs the version with the same major version number but the highest minor number and patch number. Si la version 1.2.2 est spécifiée, la version la plus élevée qui commence par 1 sera installéeIf version 1.2.2 is specified, then the highest version that starts with 1 will be installed
  • La plus élevée installe la version disponible la plus récente du package.Highest installs the highest available version of the package.

Action de conflit de fichiers spécifie la façon dont NuGet doit gérer les packages qui existent déjà dans le projet ou l’ordinateur local :File conflict action specifies how NuGet should handle packages that already exist in the project or local machine:

  • Invite indique à NuGet demander s’il faut conserver ou remplacer les packages existants.Prompt instructs NuGet to ask whether to keep or overwrite existing packages.
  • Ignorer tout indique à NuGet à ignorer le remplacement des packages existants.Ignore All instructs NuGet to skip overwriting any existing packages.
  • Remplacer tous les indique à remplacer tous les packages NuGet.Overwrite All instructs NuGet to overwrite any existing packages.

Options de désinstallationUninstall Options

(Non disponible pour tous les types de projet).(Not available for all project types.)

Supprimer les dépendances: lorsque sélectionnée, supprime tous les packages dépendants si elles ne sont pas référencées ailleurs dans le projet.Remove dependencies: when selected, removes any dependent packages if they're not referenced elsewhere in the project.

Forcer la désinstallation même s’il existe des dépendances sur ce dernier: lorsque sélectionnée, désinstalle un package même s’il est toujours référencé dans le projet.Force uninstall even if there are dependencies on it: when selected, uninstalls a package even if it's still being referenced in the project. Cela est généralement utilisé en association avec supprimer les dépendances pour supprimer un package et ce que les dépendances qu’il est installé.This is typically used in combination with Remove dependencies to remove a package and whatever dependencies it installed. À l’aide de cette option peut, toutefois, entraîner des références rompues dans le projet.Using this option may, however, lead to broken references in the project. Dans ce cas, vous devrez peut-être réinstaller ces autres packages.In such cases, you may need to reinstall those other packages.