クイック スタート: dotnet CLI でパッケージをインストールして使用する

このクイック スタートでは、一般的な Newtonsoft.Json NuGet パッケージを .NET プロジェクトにインストールします。 NuGet パッケージには、開発者が他の開発者が自分のプロジェクトで使用できるようにするコンパイル済みのバイナリ コードが含まれています。 詳細については、「 NuGet の概要」を参照してください。

パッケージをインストールするには、 dotnet コマンド ライン インターフェイス (CLI) の一部である dotnet package add コマンドを使用します。

ヒント

nuget.org/packages を参照して、独自のアプリケーションで再利用できるパッケージを見つけます。 https://nuget.org/packages で直接検索することも、Visual Studio内からパッケージを見つけてインストールすることもできます。 詳細については、「プロジェクトの NuGet パッケージを検索して評価する」を参照してください。

前提条件

dotnet CLI を提供する .NET SDK です。 Visual Studioでは、dotnet CLI は、.NET関連のワークロードと共に自動的にインストールされます。

プロジェクトを作成する

NuGet パッケージは、.NET プロジェクトにインストールできます。 このクイック スタートでは、次の手順に従って、dotnet CLI を使用して基本的な .NET コンソール プロジェクトを作成します。

  1. プロジェクトの Nuget.Quickstart という名前のフォルダーを作成します。

  2. コマンド プロンプト ウィンドウを開き、新しいフォルダーに移動します。

  3. 次のコマンドを使用してプロジェクトを作成します。

    dotnet new console

  4. dotnet runを使用してアプリをテストします。 コマンドは、次の出力を画面に書き込みます: Hello, World!。

Newtonsoft.Json NuGet パッケージを追加する

  1. 次のコマンドを使用して、Newtonsoft.Json パッケージをインストールします。

    dotnet package add Newtonsoft.Json

    .NET 9 以前を使用している場合は、代わりに動詞優先形式を使用します。

    dotnet add package Newtonsoft.Json

  2. コマンドが完了したら、Nuget.Quickstart.csproj ファイルをVisual Studioまたはテキスト エディターで開きます。 追加された NuGet パッケージ リファレンスを確認します。

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

アプリで Newtonsoft.Json API を使用する

コードでは、 using <namespace> ディレクティブを使用してインストールされているパッケージを参照します。 <namespace> はパッケージ名であることが多いです。 その後、プロジェクトでパッケージの API を使用できます。

  1. Visual Studioまたはテキスト エディターで、Program.cs ファイルを開きます。 ファイルの先頭に次の行を追加します。

    using Newtonsoft.Json;

  2. 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. ファイルを保存し、 dotnet run コマンドを使用してアプリをビルドして実行します。 出力は、コード内の Account オブジェクトの JSON 表現です。

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

パッケージ管理に NuGet を使用する方法のビデオについては、「.NET初心者向け NuGet を使用したパッケージ管理および NuGet for Beginners を参照してください。

関連するコンテンツ

dotnet CLI を使用した NuGet パッケージのインストールと使用の詳細については、次の記事を参照してください。

  • Last updated on