Schnellstart: Installieren und Verwenden eines Pakets in Visual Studio (nur Windows)Quickstart: Install and use a package in Visual Studio (Windows only)

NuGet-Pakete enthalten wiederverwendbaren Code, der von anderen Entwicklern für die Verwendung in Ihren Projekten verfügbar gemacht wird.NuGet packages contain reusable code that other developers make available to you for use in your projects. Unter Was ist NuGet? finden Sie weitere Informationen.See What is NuGet? for background. Pakete werden über den NuGet-Paket-Manager, die Paket-Manager-Konsole oder über Dotnet-CLI in einem Visual Studio-Projekt installiert.Packages are installed into a Visual Studio project using the NuGet Package Manager, the Package Manager Console, or the dotnet CLI. Dieser Artikel zeigt den Prozess mit dem beliebten Newtonsoft.Json-Paket und einem WPF-Projekt (Windows Presentation Foundation).This article demonstrates the process using the popular Newtonsoft.Json package and a Windows Presentation Foundation (WPF) project. Derselbe Prozess ist auch auf jedes andere .NET oder .NET Core-Projekt anwendbar.The same process applies to any other .NET or .NET Core project.

Beziehen Sie sich nach der Installation mit using <namespace> auf das Paket im Code, wobei <Namespace> für das von Ihnen verwendete Paket spezifisch ist.Once installed, refer to the package in code with using <namespace> where <namespace> is specific to the package you're using. Nachdem der Verweis erfolgt ist, können Sie das Paket über die zugehörige API aufrufen.Once the reference is made, you can call the package through its API.

Tipp

Einstieg in nuget.org: .NET-Entwickler finden Komponenten für die Verwendung in ihren eigenen Anwendungen üblicherweise durch das Durchsuchen von nuget.org.Start with nuget.org: Browsing nuget.org is how .NET developers typically find components they can reuse in their own applications. Sie können nuget.org direkt durchsuchen oder in Visual Studio nach Paketen suchen und diese installieren, wie in diesem Artikel dargestellt wird.You can search nuget.org directly or find and install packages within Visual Studio as shown in this article. Allgemeine Informationen finden Sie Suchen und Auswerten von NuGet-Paketen.For general information, see Find and evaluate NuGet packages.

VoraussetzungenPrerequisites

  • Visual Studio 2019 mit der .NET Desktop Development-Workload.Visual Studio 2019 with the .NET Desktop Development workload.

Sie können die 2019 Community-Edition kostenlos von visualstudio.com installieren oder die Professional oder Enterprise Edition verwenden.You can install the 2019 Community edition for free from visualstudio.com or use the Professional or Enterprise editions.

Wenn Sie Visual Studio für Mac verwenden, lesen Sie Installieren und Verwenden eines Pakets in Visual Studio für Mac.If you're using Visual Studio for Mac, see Install and use a package in Visual Studio for Mac.

Erstellen eines ProjektsCreate a project

NuGet-Pakete können in jedem beliebigen .NET-Projekt installiert werden, vorausgesetzt, das Paket unterstützt dasselbe Zielframework wie das Projekt.NuGet packages can be installed into any .NET project, provided that the package supports the same target framework as the project.

Verwenden Sie für diese exemplarische Vorgehensweise eine einfache WPF-App.For this walkthrough, use a simple WPF app. Erstellen Sie ein Projekt in Visual Studio mit Datei > Neues Projekt, geben Sie .NET in das Suchfeld ein, und wählen Sie dann die WPF App (.NET Framework) aus.Create a project in Visual Studio using File > New Project, typing .NET in the search box, and then selecting the WPF App (.NET Framework). Klicken Sie auf Weiter.Click Next. Akzeptieren Sie die Standardwerte für Framework, wenn Sie dazu aufgefordert werden.Accept the default values for Framework when prompted.

Visual Studio erstellt das Projekt, das im Projektmappen-Explorer geöffnet wird.Visual Studio creates the project, which opens in Solution Explorer.

Hinzufügen des NuGet-Pakets „Newtonsoft.Json“Add the Newtonsoft.Json NuGet package

Sie können entweder dem NuGet-Paket-Manager oder die Paket-Manager-Konsole verwenden, um das Paket zu installieren.To install the package, you can use either the NuGet Package Manager or the Package Manager Console. Beim Installieren eines Pakets zeichnet NuGet die Abhängigkeit entweder in Ihrer Projektdatei oder in einer packages.config-Datei auf (je nach Projektformat).When you install a package, NuGet records the dependency in either your project file or a packages.config file (depending on the project format). Weitere Informationen finden Sie unter Übersicht und Workflow für die Paketerstellung.For more information, see Package consumption overview and workflow.

NuGet-Paket-ManagerNuGet Package Manager

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und wählen Sie NuGet-Pakete verwalten aus.In Solution Explorer, right-click References and choose Manage NuGet Packages.

    Verwalten des Befehls für NuGet-Pakete bei Projektverweisen

  2. Wählen Sie als Paketquelle nuget.org aus. Wählen Sie anschließend die Registerkarte Durchsuchen aus, suchen Sie nach dem Paket Newtonsoft.Json, und wählen Sie das Paket in der Liste sowie anschließend Installieren aus:Choose "nuget.org" as the Package source, select the Browse tab, search for Newtonsoft.Json, select that package in the list, and select Install:

    Suchen des Pakets „Newtonsoft.Json“

    Weitere Informationen zum NuGet-Paket-Manager finden Sie unter Installieren und Verwalten von Paketen mithilfe von Visual Studio.If you want more information on the NuGet Package Manager, see Install and manage packages using Visual Studio.

  3. Akzeptieren Sie die Lizenzbedingungen.Accept any license prompts.

  4. (Nur Visual Studio 2017) Wenn Sie dazu aufgefordert werden, ein Format für die Paketverwaltung auszuwählen, wählen Sie PackageReference in Projektdatei:(Visual Studio 2017 only) If prompted to select a package management format, select PackageReference in project file:

    Auswahl eines Paketverwaltungsformats

  5. Wählen Sie OK aus, wenn Sie dazu aufgefordert werden, Änderungen zu überprüfen.If prompted to review changes, select OK.

Paket-Manager-KonsolePackage Manager Console

  1. Wählen Sie den Menübefehl Tools > NuGet-Paket-Manager > Paket-Manager-Konsole aus.Select the Tools > NuGet Package Manager > Package Manager Console menu command.

  2. Wenn die Konsole geöffnet wird, überprüfen Sie, ob die Dropdownliste Standardprojekt das Projekt anzeigt, in das Sie das Paket installieren möchten.Once the console opens, check that the Default project drop-down list shows the project into which you want to install the package. Wenn Sie ein einzelnes Projekt in der Projektmappe haben, ist es bereits ausgewählt.If you have a single project in the solution, it is already selected.

    Suchen des Pakets „Newtonsoft.Json“

  3. Geben Sie den Befehl Install-Package Newtonsoft.Json ein (siehe Install-Package).Enter the command Install-Package Newtonsoft.Json (see Install-Package). Das Konsolenfenster zeigt die Ausgabe des Befehls.The console window shows output for the command. Fehler deuten normalerweise darauf hin, dass das Paket nicht mit dem Zielframework des Projekts kompatibel ist.Errors typically indicate that the package isn't compatible with the project's target framework.

    Weitere Informationen zur Paket-Manager-Konsole finden Sie unter Installieren und Verwalten von Paketen mithilfe der Paket-Manager-Konsole.If you want more information on the Package Manager Console, see Install and manage packages using Package Manager Console.

Verwenden der API „Newtonsoft.Json“ in der AppUse the Newtonsoft.Json API in the app

Wenn das Paket „Newtonsoft.Json“ im Projekt enthalten ist, können Sie die zugehörige JsonConvert.SerializeObject-Methode aufrufen, um ein Objekt in eine lesbare Zeichenfolge zu konvertieren.With the Newtonsoft.Json package in the project, you can call its JsonConvert.SerializeObject method to convert an object to a human-readable string.

  1. Öffnen Sie MainWindow.xaml, und ersetzen Sie das vorhandene Grid-Element mit folgendem:Open MainWindow.xaml and replace the existing Grid element with the following:

    <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. Öffnen Sie die Datei MainWindow.xaml.cs (befindet sich in Projektmappen-Explorer unter dem Knoten MainWindow.xaml), und fügen Sie den folgenden Code in der MainWindow-Klasse ein:Open the MainWindow.xaml.cs file (located in Solution Explorer under the MainWindow.xaml node), and insert the following code inside the MainWindow class:

    public class Account
    {
        public string Name { get; set; }
        public string Email { get; set; }
        public DateTime DOB { get; set; }
    }
    
    private void Button_Click(object sender, RoutedEventArgs e)
    {
        Account account = new Account
        {
            Name = "John Doe",
            Email = "john@microsoft.com",
            DOB = new DateTime(1980, 2, 20, 0, 0, 0, DateTimeKind.Utc),
        };
        string json = JsonConvert.SerializeObject(account, Formatting.Indented);
        TextBlock.Text = json;
    }
    
  3. Obwohl Sie das Paket „Newtonsoft.Json“ zum Projekt hinzugefügt haben, erscheinen unter JsonConvert rote Wellenlinien, da eine using-Anweisung am Anfang der Codedatei erforderlich ist:Even though you added the Newtonsoft.Json package to the project, red squiggles appears under JsonConvert because you need a using statement at the top of the code file:

    using Newtonsoft.Json;
    
  4. Erstellen Sie die App, und führen Sie sie aus, indem Sie F5 drücken oder Debuggen > Debuggen starten auswählen:Build and run the app by pressing F5 or selecting Debug > Start Debugging:

    Ursprüngliche Ausgabe der WPF-App

  5. Klicken Sie auf die Schaltfläche, um die Inhalte des Elements „TextBlock“ anzuzeigen, das durch JSON-Text ersetzt wurde:Select on the button to see the contents of the TextBlock replaced with some JSON text:

    Ausgabe der WPF-App nach Klicken auf die Schaltfläche

Auf Channel 9 und auf YouTube finden Sie weitere Videos zu NuGet.Find more NuGet videos on Channel 9 and YouTube.

Nächste SchritteNext steps

Herzlichen Glückwunsch zur Installation und Verwendung Ihres ersten NuGet-Pakets!Congratulations on installing and using your first NuGet package!

Klicken Sie für weitere Informationen zu den Features von NuGet auf folgende Links.To explore more that NuGet has to offer, select the links below.