Dela via


Snabbstart: Installera och använda ett paket med dotnet CLI

I den här snabbstarten installerar du det populära Newtonsoft.Json NuGet-paketet i ett .NET projekt. NuGet-paket innehåller kompilerad binär kod som utvecklare gör tillgängliga för andra utvecklare att använda i sina projekt. Mer information finns i En introduktion till NuGet.

Om du vill installera paketet använder du kommandot dotnet package add , som är en del av dotnet-kommandoradsgränssnittet (CLI).

Tips/Råd

Bläddra nuget.org/packages för att hitta paket som du kan återanvända i dina egna program. Du kan söka direkt på https://nuget.org/packages, eller så kan du hitta och installera paket inifrån Visual Studio. Mer information finns i Hitta och utvärdera NuGet-paket för projektet.

Förutsättningar

.NET SDK, som tillhandahåller dotnet CLI. I Visual Studio installeras dotnet CLI automatiskt med alla .NET relaterade arbetsbelastningar.

Skapa ett projekt

Du kan installera NuGet-paket i ett .NET projekt. I den här snabbstarten gör du följande för att skapa ett grundläggande .NET konsolprojekt med hjälp av dotnet CLI:

  1. Skapa en mapp med namnet Nuget.Quickstart för projektet.

  2. Öppna ett kommandotolksfönster och gå till den nya mappen.

  3. Skapa projektet med hjälp av följande kommando:

    dotnet new console
    
  4. Använd dotnet run för att testa appen. Kommandot skriver följande utdata till skärmen: Hello, World!.

Lägg till NuGet-paketet Newtonsoft.Json

  1. Använd följande kommando för att installera Newtonsoft.Json paketet:

    dotnet package add Newtonsoft.Json
    

    Om du använder .NET 9 eller tidigare använder du det verb-första formuläret i stället:

    dotnet add package Newtonsoft.Json
    
  2. När kommandot är klart öppnar du filen Nuget.Quickstart.csproj i Visual Studio eller i en textredigerare. Sök efter den tillagda NuGet-paketreferensen:

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

Använda Newtonsoft.Json-API:et i appen

I kod refererar du till installerade paket med hjälp av ett using <namespace> direktiv, där <namespace> det ofta är paketnamnet. Du kan sedan använda paketets API i projektet.

  1. I Visual Studio eller i en textredigerare öppnar du filen Program.cs. Lägg till följande rad överst i filen:

    using Newtonsoft.Json;
    
  2. Lägg till följande kod för att ersätta instruktionen Console.WriteLine("Hello, World!");:

    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. Spara filen, och skapa sedan appen och kör den med hjälp av dotnet run-kommandot. Utdata är JSON-representationen Account av objektet i koden:

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

Videor om hur du använder NuGet för pakethantering finns i .NET Package Management with NuGet for Beginners and NuGet for Beginners.

Mer information om hur du installerar och använder NuGet-paket med hjälp av dotnet CLI finns i följande artiklar: