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

NuGet パッケージには、他の開発者がお客様のプロジェクトで使用できるようにした、再利用可能なコードが含まれます。 背景については、NuGet の紹介に関するページを参照してください。 一般的な Newtonsoft.Json パッケージに関するこの記事で説明するとおり、パッケージを .NET Core プロジェクトにインストールするには、dotnet add package コマンドを使用します。

インストール後、using <namespace> でコード内のパッケージを参照します。<namespace> は、使用しているパッケージに固有です。 その後、パッケージの API を使用できます。

ヒント

nuget.org を開始する: nuget.org を参照するのは、.NET 開発者が自身のアプリケーションで再利用可能なコンポーネントを検索するための一般的な方法です。 この記事で説明するように、nuget.org を直接検索することも、Visual Studio 内でパッケージを見つけてインストールすることもできます。

前提条件

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

プロジェクトの作成

NuGet パッケージは、ある種類の .NET プロジェクトにインストールできます。 このチュートリアルでは、次の手順に従って、単純な .NET Core コンソール プロジェクトを作成します。

  1. プロジェクトのフォルダーを作成します。

  2. コマンド プロンプトを開いて、新しいフォルダーに切り替えます。

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

    dotnet new console
    
  4. dotnet run を使用して、アプリが正しく作成されたことをテストします。

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

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

    dotnet add package Newtonsoft.Json
    
  2. コマンドが完了したら、.csproj ファイルを開いて、追加された参照を確認します。

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

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

  1. Program.csファイルを開いて、ファイルの上部に次の行を追加します。

    using Newtonsoft.Json;
    
  2. class Program 行の前に次のコードを追加します。

    public class Account
    {
        public string Name { get; set; }
        public string Email { get; set; }
        public DateTime DOB { get; set; }
    }
    
  3. Main 関数を次のコードに置き換えます。

    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);
    }
    
  4. dotnet run コマンドを使用して、アプリをビルドして実行します。 出力は、コード内の Account オブジェクトの JSON 表現になります。

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

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

次のステップ

無事に、最初の NuGet パッケージをインストールして使用できるようになりました。

NuGet による提供についてさらに詳しく調べるには、下のリンクを選択してください。