Schnellstart: Installieren und Verwenden eines Pakets mit der dotnet CLI

In dieser Schnellstartanleitung installieren Sie das beliebte Newtonsoft.Json NuGet-Paket in einem .NET Projekt. NuGet-Pakete enthalten kompilierten Binärcode, den Entwickler anderen Entwicklern zur Verwendung in ihren Projekten zur Verfügung stellen. Weitere Informationen finden Sie in einer Einführung in NuGet.

Zum Installieren des Pakets verwenden Sie den Befehl zum Hinzufügen des dotnet-Pakets , der Teil der Dotnet-Befehlszeilenschnittstelle (CLI) ist.

Voraussetzungen

Das .NET SDK, das die dotnet CLI bereitstellt. In Visual Studio wird die dotnet CLI automatisch mit allen .NET-bezogenen Workloads installiert.

Erstellen eines Projekts

Sie können NuGet-Pakete in einem .NET Projekt installieren. Führen Sie für diese Schnellstartanleitung die folgenden Schritte aus, um mithilfe der dotnet CLI ein einfaches .NET Konsolenprojekt zu erstellen:

1. Erstellen Sie einen Ordner mit dem Namen Nuget.Quickstart für das Projekt.

2. Öffnen Sie ein Eingabeaufforderungsfenster, und wechseln Sie zum neuen Ordner.

3. Erstellen Sie das Projekt mithilfe des folgenden Befehls:

   dotnet new console
   

4. Verwenden Sie dotnet run, um die App zu testen. Der Befehl schreibt die folgende Ausgabe auf den Bildschirm: Hello, World!

Hinzufügen des Newtonsoft.Json NuGet-Pakets

1. Verwenden Sie folgenden Befehl, um das Newtonsoft.Json-Paket zu installieren:

   dotnet package add Newtonsoft.Json
   

   Wenn Sie .NET 9 oder früher verwenden, nutzen Sie stattdessen die verb-first-Form.

   dotnet add package Newtonsoft.Json
   

2. Öffnen Sie nach Abschluss des Befehls die Datei Nuget.Quickstart.csproj in Visual Studio oder in einem Text-Editor. Überprüfen Sie die hinzugefügte NuGet-Paketreferenz:

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

Verwenden der Newtonsoft.Json-API in der App

Im Code verweisen Sie mithilfe einer using <namespace> Direktive auf installierte Pakete, wobei <namespace> häufig der Paketname angegeben ist. Anschließend können Sie die API des Pakets in Ihrem Projekt verwenden.

1. Öffnen Sie in Visual Studio oder in einem Text-Editor die Datei Program.cs. Fügen Sie am Anfang der Datei die folgende Zeile hinzu:

   using Newtonsoft.Json;
   

2. Fügen Sie den folgenden Code hinzu, um die Console.WriteLine("Hello, World!"); Anweisung zu ersetzen:

   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. Speichern Sie die Datei, und erstellen Sie die App, und führen Sie sie mithilfe des dotnet run Befehls aus. Die Ausgabe ist die JSON-Darstellung des Account Objekts im Code:

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

Verwandte Videos

Videos zur Verwendung von NuGet für die Paketverwaltung finden Sie unter .NET Package Management with NuGet for Beginners and NuGet for Beginners.

Verwandte Inhalte

Weitere Informationen zum Installieren und Verwenden von NuGet-Paketen mithilfe der dotnet CLI finden Sie in den folgenden Artikeln:

• Installieren und Verwalten von NuGet-Paketen mit der dotnet CLI
• Paketverbrauchsworkflow
• Suchen und Bewerten von NuGet-Paketen für Ihr Projekt
• PackageReference in Projektdateien