Schnellstart: Installieren und Verwenden eines NuGet-Pakets in Visual Studio (nur Windows)

In dieser Schnellstartanleitung verwenden Sie Microsoft Visual Studio zum Installieren und Verwenden eines NuGet-Pakets in einem Projekt. Ein NuGet-Paket enthält wiederverwendbaren Code, den andere Entwickler für die Verwendung in Ihren Projekten zur Verfügung stellen.

Sie können ein NuGet-Paket in einem Visual Studio Projekt mithilfe der NuGet-Paket-Manager, der Paket-Manager Console oder der .NET-Befehlszeilenschnittstelle (CLI) installieren. In dieser Schnellstartanleitung wird die Verwendung der NuGet-Paket-Manager und der Paket-Manager Konsole zum Installieren eines Pakets veranschaulicht. Führen Sie die Schritte zum Erstellen eines Windows Presentation Foundation-Projekts (WPF) aus, das das beliebte Newtonsoft.Json-Paket verwendet. Derselbe Vorgang gilt für alle anderen .NET Projekte.

Dieser Artikel richtet sich nur an Windows Benutzer. Wenn Sie Visual Studio für Mac verwenden, lesen Sie Installieren und verwenden Sie ein Paket in Visual Studio für Mac.

Voraussetzungen

• Installieren Sie Visual Studio 2026 mit der .NET-Desktopentwicklungs-Arbeitslast.

  Sie können die 2026 Community Edition kostenlos von visualstudio.microsoft.com installieren, oder Sie können die Professional- oder Enterprise-Edition verwenden.

Projekt erstellen

Sie können ein NuGet-Paket in einem beliebigen .NET Projekt installieren, wenn dieses Paket dasselbe Zielframework wie das Projekt unterstützt. Für diese Schnellstartanleitung erstellen Sie ein WPF Application-Projekt.

führen Sie die folgenden Schritte aus:

1. Wählen Sie in Visual Studio File>New>Project/Solution aus.

2. Wechseln Sie im Fenster " Neues Projekt erstellen " zum Suchfeld, und geben Sie "wpf" ein. Wählen Sie in der resultierenden Liste der Projektvorlagen die Vorlage WPF Application aus, die C# und Windows tags enthält, und wählen Sie dann Next aus.

3. Aktualisieren Sie im Konfigurieren Sie das neue Projekt Fenster optional den Projektnamen und Lösungsname und wählen Sie dann Weiter aus.

4. Im Fenster Weitere Informationen, wählen Sie unter Framework.NET 10.0 (oder die neueste Version) aus, und wählen Sie dann Create aus.

   Visual Studio erstellt das Projekt und wird in Projektmappen-Explorer angezeigt.

Hinzufügen des Newtonsoft.Json NuGet-Pakets

Um ein NuGet-Paket in dieser Schnellstartanleitung zu installieren, können Sie entweder die NuGet-Paket-Manager oder die Paket-Manager Konsole verwenden. Je nach Projektformat zeichnet die Installation eines NuGet-Pakets die Abhängigkeit entweder in der Projektdatei oder in einer packages.config Datei auf. Weitere Informationen finden Sie im Workflow zur Paketnutzung.

NuGet-Paket-Manager

Führen Sie die folgenden Schritte aus, um das NuGet-Paket-Manager zum Installieren des pakets Newtonsoft.Json in Visual Studio zu verwenden:

1. Wählen Sie Project>Manage NuGet Packages aus.

2. Wählen Sie auf der Seite NuGet Paket-Manager neben Package sourcenuget.org aus.

3. Wechseln Sie zur Registerkarte " Durchsuchen ", und suchen Sie nach Newtonsoft.Json. Wählen Sie in der Liste Newtonsoft.Json und dann "Installieren" aus.

   

4. Wenn Sie aufgefordert werden, die Installation zu überprüfen, wählen Sie Übernehmen aus.

Paket-Manager Konsole

Wenn Sie alternativ die Paket-Manager Console in Visual Studio verwenden möchten, um das paket Newtonsoft.Json zu installieren, führen Sie die folgenden Schritte aus:

1. Wählen Sie in Visual Studio Tools>NuGet Paket-Manager>Paket-Manager Console aus.

2. Vergewissern Sie sich oben im Fenster Paket-Manager Console, dass die Liste Default project das Projekt anzeigt, in dem Sie das Paket installieren möchten. Wenn Sie über ein einzelnes Projekt in der Projektmappe verfügen, wird es vorab ausgewählt.

   

3. Geben Sie an der Konsolenaufforderung den Befehl Install-Package Newtonsoft.Jsonein. Weitere Informationen zu diesem Befehl finden Sie unter Install-Package.

   Das Konsolenfenster zeigt die Ausgabe für den Befehl an. Fehler deuten in der Regel darauf hin, dass das Paket nicht mit dem Zielframework des Projekts kompatibel ist.

Verwenden der Newtonsoft.Json-API in der App

Nachdem Sie ein NuGet-Paket installiert haben, können Sie einen Verweis darauf in Ihrem Code erstellen, indem Sie die using <namespace> Anweisung verwenden, wobei <namespace> der Name des verwendeten Pakets ist. Nachdem Sie einen Verweis erstellt haben, können Sie das Paket über seine API aufrufen.

Mit dem Newtonsoft.Json Paket im Projekt können Sie dessen JsonConvert.SerializeObject Methode aufrufen. Gehen Sie folgendermaßen vor, um mit dieser Methode ein Objekt in eine lesbare Zeichenfolge zu konvertieren:

1. Öffnen Sie in Projektmappen-ExplorerMainWindow.xaml, und ersetzen Sie das vorhandene <Grid>-Element durch den folgenden Code:

   <Grid Background="White">
       <StackPanel VerticalAlignment="Center">
           <Button Click="Button_Click" Width="100px" HorizontalAlignment="Center" Content="Click Me" Margin="10"/>
           <TextBlock Name="TextBlock" HorizontalAlignment="Center" Text="TextBlock" Margin="10"/>
       </StackPanel>
   </Grid>
   

2. Erweitern Sie in Projektmappen-Explorer den Knoten MainWindow.xaml, und öffnen Sie dann die Datei MainWindow.xaml.cs. Fügen Sie den folgenden Code innerhalb der MainWindow Klasse nach dem Konstruktor ein:

   public class Account
   {
       public string ID { get; set; }
       public decimal Balance { get; set; }
       public DateTime Created { get; set; }
   }
   
   private void Button_Click(object sender, RoutedEventArgs e)
   {
       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, Newtonsoft.Json.Formatting.Indented);
       TextBlock.Text = json;
   }
   

3. Wenn MainWindow.xaml.cs die folgende Zeile nicht enthält, fügen Sie sie am Anfang der Datei hinzu:

   using Newtonsoft.Json;
   

   Ohne diese Linie markiert Visual Studio das JsonConvert-Objekt mit einer roten Wellenlinie, um einen Fehler anzuzeigen.

4. Um die App zu erstellen und auszuführen, wählen Sie F5 aus, oder wählen Sie "Debuggen>starten" aus.

   Das folgende Fenster wird angezeigt:

   

5. Wählen Sie Klicken Sie mich aus. Die App aktualisiert das Fenster, indem das TextBlock Objekt durch JSON-Text ersetzt wird.

   

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 Verwalten von NuGet-Paketen finden Sie in den folgenden Artikeln:

• Installieren und Verwalten von Paketen in Visual Studio mithilfe der NuGet-Paket-Manager
• Verwalten von Paketen mit der Visual Studio-Paket-Manager-Konsole (PowerShell)

Weitere Informationen zu NuGet finden Sie in den folgenden Artikeln:

• Eine Einführung in NuGet
• Paketverbrauchsworkflow
• Suchen und Bewerten von NuGet-Paketen für Ihr Projekt
• PackageReference in Projektdateien
• Installieren und Verwenden eines Pakets mit der dotnet CLI
• Newtonsoft.Json-Paket