Delen via

NuGet-pakketten installeren en beheren met de dotnet CLI

U kunt het dotnet CLI-hulpprogramma in 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 Core SDK, die de dotnet command-line tool biedt. Vanaf Visual Studio 2017 wordt de dotnet CLI automatisch geïnstalleerd met alle gerelateerde .NET- en .NET Core-workloads.

Een pakket installeren of bijwerken

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

  1. Open een opdrachtregel en ga naar de map die het projectbestand bevat.

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

    dotnet add package <PACKAGE_NAME>

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

    dotnet add package Newtonsoft.Json

  3. Nadat de opdracht is voltooid, kunt u het projectbestand openen om de pakketreferentie te bekijken.

    Open bijvoorbeeld het .csproj-bestand om de toegevoegde Newtonsoft.Json pakketreferentie weer te geven:

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

Een specifieke versie van een pakket installeren

Met dotnet add package 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 add package <PACKAGE_NAME> -v <VERSION>

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

dotnet add package Newtonsoft.Json --version 12.0.1

Lijst met pakketverwijzingen

Geef de pakketverwijzingen en versies voor uw project weer met behulp van de opdracht dotnet-lijstpakket :

dotnet list package

Een pakket verwijderen

Gebruik de opdracht dotnet remove package om een pakketreferentie uit het projectbestand te verwijderen.

dotnet remove package <PACKAGE_NAME>

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

dotnet remove package Newtonsoft.Json

Pakketten herstellen

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

.NET Core 2.0 en hoger dotnet build en dotnet run opdrachten herstellen pakketten automatisch. Vanaf NuGet 4.0 wordt dotnet restore dezelfde code uitgevoerd als nuget restore.

Een pakket herstellen met dotnet restore:

  1. Open een opdrachtregel en ga naar de map die het projectbestand bevat.
  2. Voer dotnet restoreuit.

Volgende stappen

  • Last updated on