dotnet add packagedotnet add package

Cet article s’applique à : ✓ SDK .NET Core 1.x et ultérieurThis article applies to: ✓ .NET Core 1.x SDK and later versions

NameName

dotnet add package : Ajoute une référence de package à un fichier projet.dotnet add package - Adds a package reference to a project file.

RésuméSynopsis

dotnet add [<PROJECT>] package <PACKAGE_NAME> [-h|--help] [-f|--framework] [--interactive] [-n|--no-restore] [--package-directory] [-s|--source] [-v|--version]

DescriptionDescription

La commande dotnet add package est une option pratique pour ajouter une référence de package à un fichier projet.The dotnet add package command provides a convenient option to add a package reference to a project file. Une fois que vous avez exécuté la commande, il existe un contrôle de compatibilité qui vérifie que le package est compatible avec les frameworks du projet.After running the command, there's a compatibility check to ensure the package is compatible with the frameworks in the project. Si le résultat du contrôle est positif, un élément <PackageReference> est ajouté au fichier projet et la commande dotnet restore est exécutée.If the check passes, a <PackageReference> element is added to the project file and dotnet restore is run.

Notes

À partir du kit SDK .NET Core 2.0, vous n’avez pas à exécuter dotnet restore, car il est exécuté implicitement par toutes les commandes qui réclament une restauration, comme dotnet new, dotnet build et dotnet run.Starting with .NET Core 2.0 SDK, you don't have to run dotnet restore because it's run implicitly by all commands that require a restore to occur, such as dotnet new, dotnet build and dotnet run. Cette commande reste néanmoins valide dans certains scénarios où une restauration explicite est nécessaire, comme des builds d’intégration continue dans Azure DevOps Services ou dans les systèmes de génération qui doivent contrôler explicitement le moment auquel la restauration se produit.It's still a valid command in certain scenarios where doing an explicit restore makes sense, such as continuous integration builds in Azure DevOps Services or in build systems that need to explicitly control the time at which the restore occurs.

Par exemple, l’ajout de Newtonsoft.Json à ToDo.csproj produit une sortie similaire à l’exemple suivant :For example, adding Newtonsoft.Json to ToDo.csproj produces output similar to the following example:

  Writing C:\Users\mairaw\AppData\Local\Temp\tmp95A8.tmp
info : Adding PackageReference for package 'Newtonsoft.Json' into project 'C:\projects\ToDo\ToDo.csproj'.
log  : Restoring packages for C:\Temp\projects\consoleproj\consoleproj.csproj...
info :   GET https://api.nuget.org/v3-flatcontainer/newtonsoft.json/index.json
info :   OK https://api.nuget.org/v3-flatcontainer/newtonsoft.json/index.json 79ms
info :   GET https://api.nuget.org/v3-flatcontainer/newtonsoft.json/12.0.1/newtonsoft.json.12.0.1.nupkg
info :   OK https://api.nuget.org/v3-flatcontainer/newtonsoft.json/12.0.1/newtonsoft.json.12.0.1.nupkg 232ms
log  : Installing Newtonsoft.Json 12.0.1.
info : Package 'Newtonsoft.Json' is compatible with all the specified frameworks in project 'C:\projects\ToDo\ToDo.csproj'.
info : PackageReference for package 'Newtonsoft.Json' version '12.0.1' added to file 'C:\projects\ToDo\ToDo.csproj'.

Le fichier ToDo.csproj contient à présent un élément <PackageReference> pour le package référencé.The ToDo.csproj file now contains a <PackageReference> element for the referenced package.

<PackageReference Include="Newtonsoft.Json" Version="12.0.1" />

ArgumentsArguments

  • PROJECT

    Spécifie le nom du fichier projet.Specifies the project file. Si aucun fichier n’est spécifié, la commande en recherche un dans le répertoire actuel.If not specified, the command searches the current directory for one.

  • PACKAGE_NAME

    Référence de package à ajouter.The package reference to add.

OptionsOptions

  • -f|--framework <FRAMEWORK>

    Ajoute une référence de package uniquement quand vous ciblez un framework spécifique.Adds a package reference only when targeting a specific framework.

  • -h|--help

    Affiche une aide brève pour la commande.Prints out a short help for the command.

  • --interactive

    Permet à la commande de s’arrêter et d’attendre une saisie ou une action de l’utilisateur (par exemple, s’authentifier).Allows the command to stop and wait for user input or action (for example to complete authentication). Disponible à partir du kit SDK .NET Core 2.1, version 2.1.400 (ou version ultérieure).Available since .NET Core 2.1 SDK, version 2.1.400 or later.

  • -n|--no-restore

    Ajoute une référence de package sans effectuer d’aperçu de restauration ni de contrôle de compatibilité.Adds a package reference without performing a restore preview and compatibility check.

  • --package-directory <PACKAGE_DIRECTORY>

    Répertoire où restaurer les packages.The directory where to restore the packages.

  • -s|--source <SOURCE>

    Source de package NuGet à utiliser pendant l’opération de restauration.The NuGet package source to use during the restore operation.

  • -v|--version <VERSION>

    Version du package.Version of the package. Consultez Contrôle de version du package NuGet.See NuGet package versioning.

ExemplesExamples

  • Ajouter un package NuGet Newtonsoft.Json à un projet :Add Newtonsoft.Json NuGet package to a project:

    dotnet add package Newtonsoft.Json
    
  • Ajouter une version spécifique d’un package à un projet :Add a specific version of a package to a project:

    dotnet add ToDo.csproj package Microsoft.Azure.DocumentDB.Core -v 1.0.0
    
  • Ajouter un package à l’aide d’une source NuGet spécifique :Add a package using a specific NuGet source:

    dotnet add package Microsoft.AspNetCore.StaticFiles -s https://dotnet.myget.org/F/dotnet-core/api/v3/index.json