dotnet add packagedotnet add package

Dieses Thema gilt für: ✓ .NET Core SDK 1.x .NET Core SDK 2.xThis topic applies to: ✓ .NET Core SDK 1.x .NET Core SDK 2.x

NameName

dotnet add package: Fügt einen Paketverweis zu einer Projektdatei hinzu.dotnet add package - Adds a package reference to a project file.

ÜbersichtSynopsis

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

BeschreibungDescription

Der dotnet add package-Befehl bietet eine praktische Option zum Hinzufügen von Paketverweisen zu einer Projektdatei.The dotnet add package command provides a convenient option to add a package reference to a project file. Nach dem Ausführen des Befehls wird die Kompatibilität überprüft, um sicherzustellen, dass das Paket mit den Frameworks im Projekt kompatibel ist.After running the command, there's a compatibility check to ensure the package is compatible with the frameworks in the project. Wenn die Überprüfung erfolgreich ist, wird ein <PackageReference>-Element zur Projektdatei hinzugefügt, und dotnet restore wird ausgeführt.If the check passes, a <PackageReference> element is added to the project file and dotnet restore is run.

Hinweis

Starting with .NET Core 2.0, you don't have to run dotnet restore because it's run implicitly by all commands, such as dotnet build and dotnet run, that require a restore to occur. It's still a valid command in certain scenarios where doing an explicit restore makes sense, such as continuous integration builds in Visual Studio Team Services or in build systems that need to explicitly control the time at which the restore occurs.

Beispielsweise wird durch Hinzufügen von Newtonsoft.Json zu ToDo.csproj eine Ausgabe ähnlich der folgenden erzeugt: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:\projects\ToDo\ToDo.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 235ms
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 '10.0.3' added to file 'C:\projects\ToDo\ToDo.csproj'.

Die ToDo.csproj-Datei enthält nun ein <PackageReference>-Element für das Paket, auf das verwiesen wird.The ToDo.csproj file now contains a <PackageReference> element for the referenced package.

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

ArgumenteArguments

PROJECT

Gibt die Projektdatei an.Specifies the project file. Wenn keine angegeben ist, sucht der Befehl im aktuellen Verzeichnis nach einer Projektdatei.If not specified, the command searches the current directory for one.

PACKAGE_NAME

Hinzuzufügender Paketverweis.The package reference to add.

OptionenOptions

-h|--help

Druckt eine kurze Hilfe für den Befehl.Prints out a short help for the command.

-v|--version <VERSION>

Die Version des Pakets.Version of the package.

-f|--framework <FRAMEWORK>

Fügt Paketverweise nur hinzu, wenn ein bestimmtes Framework verwendet werden soll.Adds a package reference only when targeting a specific framework.

-n|--no-restore

Fügt Paketverweise hinzu, ohne eine Vorschau der Wiederherstellung und eine Kompatibilitätsüberprüfung durchzuführen.Adds a package reference without performing a restore preview and compatibility check.

-s|--source <SOURCE>

Verwendet während des Wiederherstellungsvorgangs eine bestimmte NuGet-Paketquelle.Uses a specific NuGet package source during the restore operation.

--package-directory <PACKAGE_DIRECTORY>

Stellt das Paket im angegebenen Verzeichnis wieder her.Restores the package to the specified directory.

BeispieleExamples

Fügen Sie das Newtonsoft.Json-NuGet-Pakets zu einem Projekt hinzu:Add Newtonsoft.Json NuGet package to a project:

dotnet add package Newtonsoft.Json

Fügen Sie eine bestimmte Version eines Pakets zu einem Projekt hinzu:Add a specific version of a package to a project:

dotnet add ToDo.csproj package Microsoft.Azure.DocumentDB.Core -v 1.0.0

Fügen Sie ein Paket mit einer bestimmten NuGet-Quelle hinzu: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