Schnellstart: Installieren und Verwenden eines Pakets mithilfe der dotnet-CLIQuickstart: Install and use a package using the dotnet CLI

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 mithilfe des Befehls dotnet add package in einem .NET Core-Projekt installiert, wie in diesem Artikel für das beliebte Newtonsoft.Json-Paket beschrieben wird.Packages are installed into a .NET Core project using the dotnet add package command as described in this article for the popular Newtonsoft.Json package.

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. Sie können dann die Paket-API verwenden.You can then use the package's 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.

Erforderliche KomponentenPrerequisites

Erstellen eines ProjektsCreate a project

NuGet-Pakete können in beliebigen .NET-Projekten installiert werden.NuGet packages can be installed into a .NET project of some kind. Erstellen Sie für diese exemplarische Vorgehensweise folgendermaßen ein einfaches .NET Core-Konsolenprojekt:For this walkthrough, create a simple .NET Core console project as follows:

  1. Erstellen Sie einen Ordner für das Projekt.Create a folder for the project.

  2. Erstellen Sie das Projekt mithilfe des folgenden Befehls:Create the project using the following command:

    dotnet new console
    
  3. Verwenden Sie den Befehl dotnet run, um zu prüfen, ob die App ordnungsgemäß erstellt wurde.Use dotnet run to test that the app has been created properly.

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

  1. Verwenden Sie folgenden Befehl, um das Newtonsoft.json-Paket zu installieren:Use the following command to install the Newtonsoft.json package:

    dotnet add package Newtonsoft.Json
    
  2. Öffnen Sie die .csproj-Datei, um den hinzugefügten Verweis zu sehen, nachdem der Befehl abgeschlossen wurde:After the command completes, open the .csproj file to see the added reference:

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

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

  1. Öffnen Sie die Datei Program.cs, und fügen Sie die folgende Zeile am Anfang der Datei hinzu:Open the Program.cs file and add the following line at the top of the file:

    using Newtonsoft.Json;
    
  2. Fügen Sie den folgenden Code vor der Zeile class Program hinzu:Add the following code before the class Program line:

    public class Account
    {
        public string Name { get; set; }
        public string Email { get; set; }
        public DateTime DOB { get; set; }
    }
    
  3. Ersetzen Sie die Main-Funktion durch den folgendes:Replace the Main function with the following:

    static void Main(string[] args)
    {
        Account account = new Account
        {
            Name = "John Doe",
            Email = "john@nuget.org",
            DOB = new DateTime(1980, 2, 20, 0, 0, 0, DateTimeKind.Utc),
        };
    
        string json = JsonConvert.SerializeObject(account, Formatting.Indented);
        Console.WriteLine(json);
    }
    
  4. Erstellen Sie die App mit dem Befehl dotnet run, und führen Sie sie aus.Build and run the app by using the dotnet run command. Die Ausgabe sollte die JSON-Darstellung des Account-Objekts im Code sein:The output should be the JSON representation of the Account object in the code:

    {
      "Name": "John Doe",
      "Email": "john@nuget.org",
      "DOB": "1980-02-20T00:00:00Z"
    }