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

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.org を開始する:nuget.org を参照するのは、.NET 開発者が自身のアプリケーションで再利用可能なコンポーネントを検索するための一般的な方法です。 nuget.org を直接検索するか、この記事に示すように、パッケージを検索して Visual Studio 内にインストールすることができます。 一般的な情報については、NuGet パッケージの検索と評価に関するページをご覧ください。

前提条件

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

    visualstudio.com から無料の 2019 Community Edition をインストールするか、Professional または Enterprise Edition を使用できます。

プロジェクトの作成

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

次の手順に従います。

  1. Visual Studio で、 [ファイル]>[新規]>[プロジェクト] の順に選択します。

  2. [ 新しいプロジェクトの作成 ] ウィンドウで、検索ボックスに 「WPF」 と入力し、ドロップダウン リストで C#Windows を選択します。 テンプレートの一覧で、 [WPF アプリケーション] を選んでから、 [次へ] を選択します。

  3. [ 新しいプロジェクトの構成 ] ウィンドウで、必要に応じて [プロジェクト名 ] と [ ソリューション名] を更新し、[ 次へ] を選択します。

  4. [追加情報] ウィンドウで、Framework.NET 6.0 (または最新バージョン) を選択し、[作成] を選択します。

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

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

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

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

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

  1. [プロジェクト]>[NuGet パッケージの管理] の順に選択します。

  2. [NuGet パッケージ マネージャー] ウィンドウで、パッケージのソースとして [nuget.org] を選択します。

  3. [ 参照 ] タブで Newtonsoft.Json を検索し、一覧で [Newtonsoft.Json ] を選択し、[ インストール] を選択します。

    Newtonsoft.Json パッケージが選択された [NuGet パッケージ マネージャー] ウィンドウを示すスクリーンショット。

  4. インストールの確認を求められたら、[ OK] を選択します

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

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

  1. Visual Studio で [ツール]>[NuGet パッケージ マネージャー]>[パッケージ マネージャー コンソール] の順に選択します。

  2. コンソールが開いたら、 [既定のプロジェクト] ドロップダウン リストに、パッケージをインストールするプロジェクトが表示されていることを確認します。 ソリューション内に単一のプロジェクトがあれば、それは既に選択されています。

    既定のプロジェクトが強調表示されている [パッケージ管理コンソール] ウィンドウを示すスクリーンショット。

  3. コンソール プロンプトで、コマンドを入力します Install-Package Newtonsoft.Json。 PowerShell コマンドの詳細については、「 Install-WindowsFeature」を参照してください。

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

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

プロジェクトに Newtonsoft.Json パッケージがある場合、その Newtonsoft.Json メソッドを呼び出し、オブジェクトを人間が読める文字列に変換できます。

  1. ソリューション エクスプローラーserver.js を開き、既存のコードを次のコードと置き換えます。

    <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>
    
  2. 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, Formatting.Indented);
        TextBlock.Text = json;
    }
    
  3. コード内のオブジェクトのエラー JsonConvert を回避するには (赤い波線が表示されます)、コード ファイルの先頭に次のステートメントを追加します。

    using Newtonsoft.Json;
    
  4. アプリをビルドして実行するには、F5 キーを押すか、[ デバッグ>の開始] を選択します。

    次のウィンドウが表示されます。

    WPF アプリの初期出力を示すスクリーンショット。

  5. ボタンを選択し、TextBlock の内容が JSON テキストに置換されたことを確認します。

    ボタンを選択した後の WPF アプリの出力を示すスクリーンショット。

関連項目

UWP の詳細については、次の記事を参照してください。

次の手順

無事に、最初の NuGet パッケージをインストールして使用できるようになりました。 NuGet パッケージのインストールと管理の詳細については、次の記事に進んでください。