Share via

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

  • [アーティクル]

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

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

ヒント

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

前提条件

  • .NET SDK。これは、dotnet コマンドライン ツールを提供します。 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 パッケージをインストールして使用できるようになりました。

他の NuGet ビデオは、Channel 9 および YouTube でご覧いただけます。

次のステップ

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

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