Udostępnij za pośrednictwem

Szybki start: instalowanie i używanie pakietu za pomocą interfejsu wiersza polecenia dotnet

W tym szybkim starcie zainstalujesz popularny pakiet Newtonsoft.Json NuGet w projekcie .NET. Pakiety NuGet zawierają skompilowany kod binarny, który deweloperzy udostępniają innym deweloperom do użycia w swoich projektach. Aby uzyskać więcej informacji, zobacz Wprowadzenie do narzędzia NuGet.

Aby zainstalować pakiet, należy użyć polecenia dotnet package add , który jest częścią interfejsu wiersza polecenia dotnet (CLI).

Wskazówka

Przeglądaj nuget.org/packages , aby znaleźć pakiety, których można używać ponownie we własnych aplikacjach. Możesz wyszukiwać bezpośrednio pod adresem https://nuget.org/packages lub znaleźć i zainstalować pakiety z poziomu Visual Studio. Aby uzyskać więcej informacji, zobacz Znajdowanie i ocenianie pakietów NuGet dla projektu.

Wymagania wstępne

Zestaw SDK .NET, który udostępnia dotnet CLI. W Visual Studio dotnet CLI jest automatycznie instalowane razem z dowolnymi zestawami zadań powiązanymi z .NET.

Tworzenie projektu

Pakiety NuGet można zainstalować w projekcie .NET. W tym przewodniku wprowadzenia wykonaj następujące kroki, aby utworzyć podstawowy projekt konsolowy .NET przy użyciu konsoli dotnet CLI:

  1. Utwórz folder o nazwie Nuget.Quickstart dla projektu.

  2. Otwórz okno wiersza polecenia i przejdź do nowego folderu.

  3. Utwórz projekt przy użyciu następującego polecenia:

    dotnet new console

  4. Użyj polecenia dotnet run , aby przetestować aplikację. Polecenie zapisuje następujące dane wyjściowe na ekranie: Hello, World!.

Dodaj pakiet NuGet Newtonsoft.Json

  1. Użyj następującego polecenia, aby zainstalować Newtonsoft.Json pakiet:

    dotnet package add Newtonsoft.Json

    Jeśli używasz .NET 9 lub starszej wersji, zamiast tego używaj formy czasownika jako pierwszej:

    dotnet add package Newtonsoft.Json

  2. Po zakończeniu polecenia otwórz plik Nuget.Quickstart.csproj w Visual Studio lub w edytorze tekstów. Sprawdź, czy dodano odwołanie do pakietu NuGet:

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

Korzystanie z interfejsu API Newtonsoft.Json w aplikacji

W kodzie odwołujesz się do zainstalowanych pakietów przy użyciu using <namespace> dyrektywy, gdzie <namespace> często jest nazwą pakietu. Następnie możesz użyć interfejsu API pakietu w projekcie.

  1. W Visual Studio lub w edytorze tekstów otwórz plik Program.cs. Dodaj następujący wiersz na początku pliku:

    using Newtonsoft.Json;

  2. Dodaj następujący kod, aby zastąpić instrukcję 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. Zapisz plik, a następnie skompiluj i uruchom aplikację przy użyciu dotnet run polecenia . Dane wyjściowe to obiekt Account w kodzie w reprezentacji JSON.

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

Aby uzyskać wideo dotyczące korzystania z narzędzia NuGet do zarządzania pakietami, zobacz .NET Zarządzanie pakietami za pomocą narzędzia NuGet dla początkujących i NuGet dla początkujących.

Treści powiązane

Aby dowiedzieć się więcej na temat instalowania i używania pakietów NuGet przy użyciu interfejsu wiersza polecenia dotnet, zobacz następujące artykuły:

  • Last updated on