NuGet-pakketten installeren en beheren met de dotnet CLI

U kunt het opdrachtregelprogramma dotnet (CLI) op Windows, macOS of Linux gebruiken om NuGet-pakketten eenvoudig te installeren, te verwijderen en bij te werken in .NET projecten en oplossingen. In dit artikel worden de meest voorkomende dotnet CLI-opdrachten beschreven voor het beheren van NuGet-pakketten.

De dotnet CLI wordt uitgevoerd op .NET, .NET Core, .NET Standard SDK-projecten en andere SDK-projecten, bijvoorbeeld projecten die gericht zijn op .NET Framework. Zie .NET-project-SDK's voor meer informatie.

Voor de meeste opdrachten zoekt het CLI-hulpprogramma naar een projectbestand in de huidige map, tenzij een ander projectbestand is opgegeven als een optionele schakeloptie in de opdracht. Zie dotnet CLI-opdrachten voor een volledige lijst met opdrachten en de bijbehorende argumenten.

Vereiste voorwaarden

De .NET SDK, die de dotnet CLI biedt. In Visual Studio wordt de dotnet CLI automatisch geïnstalleerd met alle .NET-gerelateerde workloads.

Een pakket installeren of bijwerken

De opdracht dotnet package add voegt een pakketreferentie toe aan het projectbestand en wordt vervolgens uitgevoerd dotnet restore om het pakket te installeren.

  1. Open een opdrachtregelvenster en ga naar de map met het projectbestand.

  2. Gebruik de volgende opdracht om een NuGet-pakket te installeren:

    dotnet package add <package-name>

    Als u bijvoorbeeld het Newtonsoft.Json pakket wilt installeren, gebruikt u de volgende opdracht:

    dotnet package add Newtonsoft.Json

    Als u .NET 9 of eerder gebruikt, gebruikt u in plaats daarvan de werkwoord-eerste vorm van de opdracht:

    dotnet add package <package-name>

  3. Nadat de opdracht is voltooid, opent u het projectbestand om te controleren op de pakketreferentie.

    Open bijvoorbeeld het .csproj-bestand en controleer op de toegevoegde Newtonsoft.Json pakketreferentie:

    <ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="13.0.4" />
</ItemGroup>

Een specifieke versie van een pakket installeren

Met dotnet package add de opdracht wordt de nieuwste versie van het pakket geïnstalleerd, tenzij u een andere versie opgeeft.

Als u een specifieke versie van een NuGet-pakket wilt installeren, gebruikt u de optionele -v of --version switch:

dotnet package add <package-name> -v <version>

Als u bijvoorbeeld versie 13.0.1 van het Newtonsoft.Json pakket wilt toevoegen, gebruikt u deze opdracht:

dotnet package add Newtonsoft.Json --version 13.0.1

Lijst met pakketverwijzingen

U kunt de opdracht dotnet-pakketlijst gebruiken om de pakketverwijzingen en versies voor uw project weer te geven. Voer in de map met het projectbestand de volgende opdracht uit:

dotnet package list

Als u .NET 9 of eerder gebruikt, gebruik dan in plaats daarvan de werkwoord-eerste vorm.

dotnet list package

Een pakket verwijderen

U kunt de opdracht dotnet-pakket verwijderen gebruiken om een pakketreferentie uit het projectbestand te verwijderen. Voer in de map met het projectbestand de volgende opdracht uit:

dotnet package remove <package-name>

Als u bijvoorbeeld het Newtonsoft.Json pakket wilt verwijderen, gebruikt u de volgende opdracht:

dotnet package remove Newtonsoft.Json

Als u .NET 9 of eerder gebruikt, gebruik dan in plaats daarvan de werkwoord-eerste vorm.

dotnet remove package <package-name>

Pakketten herstellen

Met de dotnet restore opdracht worden pakketten hersteld die worden vermeld in <PackageReference> elementen in het projectbestand. Zie voor meer informatiePackageReference in projectbestanden.

Vanaf .NET Core 2.0 en verder in .NET worden de dotnet build en dotnet run commando's automatisch gebruikt om pakketten te herstellen, net als vele andere dotnet CLI-commando's. Vanaf NuGet 4.0 wordt dotnet restore dezelfde code uitgevoerd als de nuget restore NuGet CLI-opdracht.

Pakketten herstellen met behulp van dotnet restore:

  1. Open een opdrachtregelvenster en ga naar de map met het projectbestand.
  2. Voer dotnet restoreuit.

Verwante inhoud

  • Last updated on