Paket dotnet-add

Name

dotnet-add package: Fügt einen Paketverweis zu einer Projektdatei hinzu.

Übersicht

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

Beschreibung

Der dotnet add package-Befehl bietet eine praktische Option zum Hinzufügen von Paketverweisen zu einer Projektdatei. Nach dem Ausführen des Befehls wird die Kompatibilität überprüft, um sicherzustellen, dass das Paket mit den Frameworks im Projekt kompatibel ist. Wenn die Überprüfung erfolgreich ist, wird ein <PackageReference>-Element zur Projektdatei hinzugefügt, und dotnet restore wird ausgeführt.

Beispielsweise wird durch Hinzufügen von Newtonsoft.Json zu ToDo.csproj eine Ausgabe ähnlich der folgenden erzeugt:

Microsoft (R) Build Engine version 15.1.545.13942
Copyright (C) Microsoft Corporation. All rights reserved.

Writing /var/folders/gj/1mgg_4jx7mbdqbhw1kgcpcjr0000gn/T/tmpm0kTMD.tmp
info : Adding PackageReference for package 'Newtonsoft.Json' into project 'ToDo.csproj'.
log  : Restoring packages for 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 119ms
info :   GET https://api.nuget.org/v3-flatcontainer/newtonsoft.json/9.0.1/newtonsoft.json.9.0.1.nupkg
info :   OK https://api.nuget.org/v3-flatcontainer/newtonsoft.json/9.0.1/newtonsoft.json.9.0.1.nupkg 27ms
info : Package 'Newtonsoft.Json' is compatible with all the specified frameworks in project 'ToDo.csproj'.
info : PackageReference for package 'Newtonsoft.Json' version '9.0.1' added to file 'ToDo.csproj'.

Die ToDo.csproj-Datei enthält nun ein <PackageReference>-Element für das Paket, auf das verwiesen wird.

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

Argumente

PROJECT

Gibt die Projektdatei an. Wenn keine angegeben ist, sucht der Befehl im aktuellen Verzeichnis nach einer Projektdatei.

PACKAGE_NAME

Hinzuzufügender Paketverweis.

Optionen

-h|--help

Druckt eine kurze Hilfe für den Befehl.

-v|--version <VERSION>

Die Version des Pakets.

-f|--framework <FRAMEWORK>

Fügt Paketverweise nur hinzu, wenn ein bestimmtes Framework verwendet werden soll.

-n|--no-restore

Fügt Paketverweise hinzu, ohne eine Vorschau der Wiederherstellung und eine Kompatibilitätsüberprüfung durchzuführen.

-s|--source <SOURCE>

Verwendet während des Wiederherstellungsvorgangs eine bestimmte NuGet-Paketquelle.

--package-directory <PACKAGE_DIRECTORY>

Stellt das Paket im angegebenen Verzeichnis wieder her.

Beispiele

Fügen Sie das Newtonsoft.Json-NuGet-Pakets zu einem Projekt hinzu:

dotnet add package Newtonsoft.Json

Fügen Sie eine bestimmte Version eines Pakets zu einem Projekt hinzu:

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

Fügen Sie ein Paket mit einer bestimmten NuGet-Quelle hinzu:

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