クイックスタート: Visual Studio で NuGet パッケージをインストールして使用する (Windows のみ)

[アーティクル]
2025-03-05

NuGet パッケージ には、他の開発者がプロジェクトで使用できるようにした再利用可能なコードが含まれています。 NuGet パッケージマネージャー、パッケージマネージャーコンソール、または .NET CLIを使用して、Microsoft Visual Studio プロジェクトに NuGet パッケージをインストールできます。この記事では、一般的な Newtonsoft.Json パッケージを使用して Windows Presentation Foundation (WPF) プロジェクトを作成する方法について説明します。他の .NET または .NET Core プロジェクトにも同じプロセスが適用されます。

NuGet パッケージをインストールした後は、using <namespace> ステートメントを使用してコード内で参照できます。名前空間 <> は、使用しているパッケージの名前です。参照を作成したら、その API を使用してパッケージを呼び出すことができます。

この記事は Windows ユーザーのみを対象としています。 Visual Studio for Mac を使用している場合は、「Visual Studio for Macでパッケージをインストールして使用する」を参照してください。

ヒント

NuGet パッケージを見つけるには、nuget.orgから始めます。nuget.org の参照は、.NET 開発者が通常、独自のアプリケーションで再利用できるコンポーネントを見つける方法です。この記事に示すように、nuget.org を直接検索することも、Visual Studio 内でパッケージを検索してインストールすることもできます。詳細については、「NuGet パッケージを検索して評価する」を参照してください。

前提条件

.NET デスクトップ開発ワークロードを使用して Visual Studio 2022 for Windows をインストールします。

2022 Community エディションは、visualstudio.microsoft.comから無料でインストールすることも、Professional または Enterprise エディションを使用することもできます。

プロジェクトを作成する

NuGet パッケージがプロジェクトと同じターゲットフレームワークをサポートしている場合は、任意の .NET プロジェクトに NuGet パッケージをインストールできます。ただし、このクイックスタートでは、Windows Presentation Foundation (WPF) アプリケーションプロジェクトを作成します。

次の手順に従います。

Visual Studio で、[ファイル]>[新しい>プロジェクト] を選択します。
[新しいプロジェクト の作成] ウィンドウで、検索ボックスに「WPF」を入力し、プルダウンリストで「C#」と「Windows」を選択します。結果のプロジェクトテンプレートの一覧で、WPF アプリケーション選択し、次を選択します。
[新しいプロジェクト の構成] ウィンドウで、必要に応じて プロジェクト名の と ソリューション名のを更新し、[次へ] 選択します。
ja-JP: [追加情報] ウィンドウで、.NET 6.0 (または最新バージョン) を Frameworkとして選択し、[作成]を選択します。

Visual Studio によってプロジェクトが作成され、ソリューションエクスプローラー表示されます。

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

このクイックスタートで NuGet パッケージをインストールするには、NuGet パッケージマネージャーまたはパッケージマネージャーコンソールを使用します。 NuGet パッケージのインストールは、プロジェクトの形式に応じて、プロジェクトファイルまたは packages.config ファイルのいずれかに依存関係を記録します。詳細については、「パッケージ消費ワークフロー」を参照してください。

NuGet パッケージマネージャー

NuGet パッケージマネージャーを使用して Visual Studio に Newtonsoft.Json パッケージをインストールするには、次の手順に従います。

[プロジェクト]>[NuGet パッケージの管理]を選択します。
NuGet パッケージマネージャー ページで、パッケージソースとして nuget.org を選択します。
[参照] タブで Newtonsoft.Jsonを検索し、一覧から [Newtonsoft.Json] を選択し、[インストール] を選択します。
インストールの確認を求めるメッセージが表示されたら、[OK] 選択します。

パッケージマネージャーコンソール

または、Visual Studio でパッケージマネージャーコンソールを使用して Newtonsoft.Json パッケージをインストールするには、次の手順に従います。

Visual Studio で、ツール>NuGet パッケージマネージャー>パッケージマネージャーコンソールを選択します。
[パッケージマネージャーコンソールの] ウィンドウが開いたら、[既定 プロジェクト] ドロップダウンリストに、パッケージをインストールするプロジェクトが表示されていることを確認します。ソリューションに 1 つのプロジェクトがある場合は、事前に選択されています。
コンソールプロンプトで、コマンド Install-Package Newtonsoft.Jsonを入力します。このコマンドの詳細については、「Install-Package」を参照してください。

コンソールウィンドウにコマンドの出力が表示されます。通常、エラーは、パッケージがプロジェクトのターゲットフレームワークと互換性を持たないことを示します。

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

プロジェクト内の Newtonsoft.Json パッケージを使用して、その JsonConvert.SerializeObject メソッドを呼び出して、オブジェクトを人間が判読できる文字列に変換します。

ソリューションエクスプローラーから MainWindow.xaml 開き、既存の <Grid> 要素を次のコードに置き換えます。

<Grid Background="White">
    <StackPanel VerticalAlignment="Center">
        <Button Click="Button_Click" Width="100px" HorizontalAlignment="Center" Content="Click Me" Margin="10"/>
        <TextBlock Name="TextBlock" HorizontalAlignment="Center" Text="TextBlock" Margin="10"/>
    </StackPanel>
</Grid>

MainWindow.xaml ノードの下にある MainWindow.xaml.cs ファイルを開き、コンストラクターの後に次のコードを MainWindow クラス内に挿入します。

public class Account
{
    public string Name { get; set; }
    public string Email { get; set; }
    public DateTime DOB { get; set; }
}

private void Button_Click(object sender, RoutedEventArgs e)
{
    Account account = new Account
    {
        Name = "John Doe",
        Email = "john@microsoft.com",
        DOB = new DateTime(1980, 2, 20, 0, 0, 0, DateTimeKind.Utc),
    };
    string json = JsonConvert.SerializeObject(account, Newtonsoft.Json.Formatting.Indented);
    TextBlock.Text = json;
}

コード内の JsonConvert オブジェクトのエラーを回避するには (赤い波線が表示されます)、コードファイルの先頭に次のステートメントを追加します。
```
using Newtonsoft.Json;
```
アプリをビルドして実行するには、F5 キーを押すか、[デバッグ] >[デバッグの開始]選択します。

次のウィンドウが表示されます。
Click Me ボタンを選ぶと、JSON テキストに置き換えられた TextBlock オブジェクトの内容が表示されます。

Channel 9 で NuGet ビデオを検索し、YouTube をします。

次の手順

初めての NuGet パッケージのインストールと使用はこれで完了です。 NuGet パッケージのインストールと管理の詳細については、次の記事に進んでください。

NuGet パッケージマネージャーを使用してパッケージをインストールおよび管理する

パッケージマネージャーコンソールを使用してパッケージをインストールおよび管理する

次の方法で共有

クイック スタート: Visual Studio で NuGet パッケージをインストールして使用する (Windows のみ)

前提 条件

プロジェクトを作成する

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

NuGet パッケージ マネージャー

パッケージ マネージャー コンソール

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

関連ビデオ

関連項目

次の手順

フィードバック

その他のリソース

クイックスタート: Visual Studio で NuGet パッケージをインストールして使用する (Windows のみ)

前提条件

NuGet パッケージマネージャー

パッケージマネージャーコンソール