Quickstart: Een pakket installeren en gebruiken met de dotnet CLI

In deze quickstart installeert u het populaire Newtonsoft.Json NuGet-pakket in een .NET project. NuGet-pakketten bevatten gecompileerde binaire code die ontwikkelaars beschikbaar stellen voor andere ontwikkelaars die in hun projecten kunnen worden gebruikt. Zie Een inleiding tot NuGet voor meer informatie.

Als u het pakket wilt installeren, gebruikt u de opdracht dotnet package add , die deel uitmaakt van de dotnet-opdrachtregelinterface (CLI).

Hint

Blader nuget.org/packages naar pakketten die u opnieuw kunt gebruiken in uw eigen toepassingen. U kunt rechtstreeks op https://nuget.org/packages zoeken of pakketten zoeken en installeren vanuit Visual Studio. Zie NuGet-pakketten zoeken en evalueren voor uw project voor meer informatie.

Vereiste voorwaarden

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

Een project maken

U kunt NuGet-pakketten installeren in een .NET-project. Voer voor deze quickstart de volgende stappen uit om een eenvoudig .NET consoleproject te maken met behulp van de dotnet CLI:

  1. Maak een map met de naam Nuget.Quickstart voor het project.

  2. Open een opdrachtpromptvenster en ga naar de nieuwe map.

  3. Maak het project met behulp van de volgende opdracht:

    dotnet new console

  4. Gebruik dotnet run dit om de app te testen. Met de opdracht wordt de volgende uitvoer naar het scherm geschreven: Hello, World!.

Het NuGet-pakket Newtonsoft.Json toevoegen

  1. Gebruik de volgende opdracht om het Newtonsoft.Json pakket te installeren:

    dotnet package add Newtonsoft.Json

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

    dotnet add package Newtonsoft.Json

  2. Nadat de opdracht is voltooid, opent u het bestand Nuget.Quickstart.csproj in Visual Studio of in een teksteditor. Controleer op de toegevoegde NuGet-pakketreferentie:

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

De Newtonsoft.Json-API gebruiken in de app

In code verwijst u naar geïnstalleerde pakketten met behulp van een using <namespace> instructie, waar <namespace> vaak de pakketnaam is. Vervolgens kunt u de API van het pakket in uw project gebruiken.

  1. Open in Visual Studio of in een teksteditor het bestand Program.cs. Voeg de volgende regel toe aan het begin van het bestand:

    using Newtonsoft.Json;

  2. Voeg de volgende code toe om de Console.WriteLine("Hello, World!"); instructie te vervangen:

    namespace Nuget.Quickstart
{
    public class Account
    {
        public string? Id { get; set; }
        public decimal Balance { get; set; }
        public DateTime Created { get; set; }
    }
    internal class Program
    {
        static void Main(string[] args)
        {
            Account account = new Account
            {
                Id = "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u",
                Balance = 4389.21m,
                Created = new DateTime(2026, 4, 16, 0, 0, 0, DateTimeKind.Utc),
            };

            string json = JsonConvert.SerializeObject(account, Formatting.Indented);
            Console.WriteLine(json);
        }
    }
}

  3. Sla het bestand op en bouw en voer de app uit met behulp van de dotnet run opdracht. De uitvoer is de JSON-weergave van het Account object in de code:

    {
  "Id": "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u",
  "Balance": 4389.21,
  "Created": "2026-04-16T00:00:00Z"
}

Zie voor video's over het gebruik van NuGet voor pakketbeheer .NET Package Management met NuGet voor beginners en NuGet voor beginners.

Verwante inhoud

Zie de volgende artikelen voor meer informatie over het installeren en gebruiken van NuGet-pakketten met behulp van de dotnet CLI:

  • Last updated on