Schnellstart: Installieren und Verwenden eines Pakets mithilfe der dotnet CLI

  • Artikel

NuGet-Pakete enthalten kompilierten Binär-Code, der von anderen Entwicklern für die Verwendung in Ihren Projekten verfügbar gemacht wird. Weitere Informationen finden Sie unter Was ist NuGet? In dieser Schnellstartanleitung wird beschrieben, wie Sie das beliebte Newtonsoft.Json NuGet-Paket mithilfe des dotnet-Add-Paketbefehls in einem .NET-Projekt installieren.

Sie verweisen auf installierte Pakete im Code mit einer using <namespace> Direktive, bei der <namespace> häufig der Paketname ist. Sie können dann die Paket-API in Ihrem Projekt verwenden.

Tipp

Durchsuchen Sie nuget.org/packages, um Pakete zu finden, die Sie in Ihren eigenen Anwendungen wiederverwenden können. Sie können https://nuget.org direkt durchsuchen oder in Visual Studio nach Paketen suchen und diese installieren, wie in diesem Artikel dargestellt wird. Allgemeine Informationen finden Sie Suchen und Auswerten von NuGet-Paketen für Ihr Projekt.

Voraussetzungen

  • Das .NET SDK, das das Befehlszeilentool dotnet bietet. Ab Visual Studio 2017 wird die dotnet CLI automatisch mit jeder .NET oder .NET-Core-bezogenen Workload installiert.

Erstellen eines Projekts

Sie können NuGet-Pakete in ein .NET-Projekt installieren. Erstellen Sie für diese Vorgehensweise folgendermaßen ein einfaches .NET Core-Konsolenprojekt mithilfe der dotnet CLI:

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

  2. Öffnen Sie eine Eingabeaufforderung, und navigieren 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 Die Ausgabe Hello, World! sollte angezeigt werden.

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

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

    dotnet add package Newtonsoft.Json

  2. Öffnen Sie nach Abschluss des Befehls die Datei Nuget.Quickstart.csproj in Visual Studio, um die hinzugefügte NuGet-Paketreferenz anzuzeigen:

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

Verwenden der API „Newtonsoft.Json“ in der App

  1. Öffnen Sie die Datei Program.cs in Visual Studio, und fügen Sie Ihr am Anfang 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? Name { get; set; }
        public string? Email { get; set; }
        public DateTime DOB { get; set; }
    }
    internal class Program
    {
        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);
        }
    }
}

  3. Speichern Sie die Datei, und erstellen Sie dann die App mit dem Befehl dotnet run, und führen Sie sie aus. Die Ausgabe sollte die JSON-Darstellung des Account-Objekts im Code sein:

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

Herzlichen Glückwunsch zur Installation und Verwendung Ihres ersten NuGet-Pakets!

Auf Channel 9 und auf YouTube finden Sie weitere Videos zu NuGet.

Nächste Schritte

Erfahren Sie mehr über die Installation und Verwendung von NuGet-Paketen mit der dotnet CLI:

Installieren und Verwalten von Paketen mit der dotnet CLI