Visual Studio 接続済みサービスを使用して Azure SignalR を追加する

Visual Studio では、 接続済みサービス 機能を使用して、次のいずれかを Azure SignalR サービスに接続できます。

  • .NET Framework コンソール アプリ
  • ASP.NET モデル-ビュー-コントローラー (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (コンソール アプリ、WPF、Windows フォーム、クラス ライブラリを含む)
  • .NET Core ワーカー ロール
  • Azure Functions
  • ユニバーサル Windows プラットフォーム アプリ
  • Cordova

接続されたサービス機能により、必要なすべての参照と接続コードがプロジェクトに追加され、構成ファイルが適切に変更されます。

[前提条件]

接続済みサービスを使用して Azure SignalR に接続する

注

.NET Framework プロジェクトの場合、接続済みサービス UI は若干異なります。 違いを確認するには、 このページの Visual Studio 2019 バージョンと比較してください。

  1. Visual Studio でプロジェクトを開きます。

  2. ソリューション エクスプローラーで、[接続済みサービス] ノードを右クリックし、コンテキスト メニューから [追加] を選択して、使用可能なサービスのメニューを開きます。

    接続済みサービスのコンテキスト メニュー オプションを示すスクリーンショット。

    [ 接続済みサービス ] ノードが表示されない場合は、 Project>Connected Services>Add を選択します。

  3. [Azure SignalR Service] を選択します。 [ 依存関係への接続] ページが表示されます。

    Azure SignalR の依存関係への接続を示すスクリーンショット。

    まだサインインしていない場合は、Azure アカウントにサインインします。 Azure アカウントをお持ちでない場合は、 無料試用版にサインアップできます。

  4. 既存の Azure SignalR コンポーネントを選択し、[ 次へ] を選択します。

    新しいコンポーネントを作成する必要がある場合は、次の手順に進みます。 それ以外の場合は、手順 7 に進みます。

    [Connect to existing Azure SignalR component]\(既存の Azure SignalR コンポーネントに接続する\) 画面を示すスクリーンショット。

  5. Azure SignalR サービス インスタンスを作成するには:

    1. 画面の中央右にある [ 新規作成 ] を選択します。

    2. [Azure SignalR Service: Create new]\(新しい作成\) 画面に入力し、[作成] を選択します。

      [New Azure SignalR Service instance]\(新しい Azure SignalR Service インスタンス\) 画面を示すスクリーンショット。

    3. [Azure SignalR Service の構成] 画面が表示されると、新しいインスタンスが一覧に表示されます。 一覧で新しいインスタンスを選択し、[ 次へ] を選択します。

  6. 接続設定名を入力するか、既定値をそのまま使用します。

    [接続文字列の指定] 画面を示すスクリーンショット。

    注

    セキュリティを強化するために、Visual Studio 17.12 以降では、この手順によって接続設定名が作成されます。以前のバージョンでは接続文字列が作成されます。 ローカル ファイルシステムに格納されている接続文字列は、誤って公開された場合にセキュリティ 上のリスクにつながる可能性があります。

  7. [ 追加の設定 ] をクリックし、接続情報をローカル シークレット ファイルに格納するか、 Azure Key Vault に格納するかを選択します。

    接続設定を格納するためのオプションを含む追加の設定を示すスクリーンショット。

  8. [ 変更の概要] 画面には、プロセスを完了した場合にプロジェクトに加えられるすべての変更が表示されます。 変更が [OK] に見える場合は、[ 完了] を選択します。

    [変更の概要] 画面を示すスクリーンショット。

  9. ソリューション エクスプローラーで、[ 接続済みサービス ] ノードをダブルクリックして 、[ 接続済みサービス ] タブを開きます。[ サービスの依存関係 ] セクションに接続が表示されます。

    [サービスの依存関係] セクションを示すスクリーンショット。

    追加した依存関係の横にある 3 つの点をクリックすると、 接続 などのさまざまなオプションが表示され、ウィザードを再度開いて接続を変更できます。 また、ウィンドウの右上にある 3 つのドットをクリックして、ローカルの依存関係を開始したり、設定を変更したりするためのオプションを表示することもできます。

次のステップ

引き続き、Azure SignalR のクイックスタートに従います。 初期セットアップは既に完了しているのでスキップして、「 Azure SignalR を Web アプリに追加する」セクションに進んでください。 使用するコードは ASP.NET Core のバージョンによって異なるため、ASP.NET Core のバージョンがクイックスタートで使用されているバージョンと一致しない場合は、プロジェクト テンプレートに合わせてチュートリアルのコードを変更する必要がある場合があります。

関連コンテンツ

  • Last updated on