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

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

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

前提条件

• dotnetコマンドライン ツールを提供する .NET SDK。 Visual Studio 2017 以降、dotnet CLI は、.NET または .NET Core 関連のワークロードと共に自動的にインストールされます。

プロジェクトを作成する

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 add package Newtonsoft.Json
   

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

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

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

1. Visual Studio で 、Program.cs ファイルを開き、ファイルの先頭に次の行を追加します。

   using Newtonsoft.Json;
   

2. Console.WriteLine("Hello, World!"); ステートメントを置き換える次のコードを追加します。

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

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

初めての NuGet パッケージのインストールと使用を完了しました。

関連ビデオ

チャンネル 9 と YouTube で、その他の NuGet ビデオを見つけます。

次のステップ

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

• パッケージの使用の概要とワークフロー
• パッケージを検索して選択する
• プロジェクトファイルでのパッケージ参照