使用 Visual Studio 已連線的服務新增 Azure SignalR

使用 Visual Studio 時,您可以使用 [已連線的服務] 功能,將下列任何一項連線到 Azure SignalR:

  • .NET Framework 主控台應用程式
  • ASP.NET 模型-視圖-控制程式 (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (包括主控台應用程式、WPF、Windows Forms、類別庫)
  • .NET Core 背景工作角色
  • Azure Functions
  • 通用 Windows 平台應用程式
  • Xamarin
  • Cordova

已連接服務功能會將所有必要的參考和連接程式碼新增到您的專案中,並適當地修改組態檔。

注意

本主題適用於 Windows 上的 Visual Studio。 若是 Visual Studio for Mac,請參閱 Visual Studio for Mac 中已連線的服務

必要條件

使用已連線的服務連線到 Azure SignalR

  1. 在 Visual Studio 中,開啟您的專案。

  2. 在 [方案總管] 中,於 [已連線的服務] 節點上按一下滑鼠右鍵,然後從捷徑功能表中選取 [已連線的服務]

  3. 在 [已連線的服務] 索引標籤中,選取 [服務相依性] 的 + 圖示。

    Add Service Dependency

  4. 在 [新增相依性] 頁面中,選取 [Azure SignalR Service]

    Add Azure SignalR Service

    如果您尚未登入,請登入您的 Azure 帳戶。 如果您沒有 Azure 帳戶,您可以註冊免費試用

  5. 在 [設定 Azure SignalR] 畫面中,選取現有的 Azure SignalR 元件,然後選取 [下一步]

    如果您需要建立新的元件,請移至下一個步驟。 否則,請跳至步驟 7。

    Connect to existing Azure SignalR component

  6. 若要建立 Azure SignalR 服務執行個體:

    1. 選取畫面底部的 [建立新的 Azure SignalR Service 執行個體]

    2. 填寫 [Azure SignalR Service:新建] 畫面,然後選取 [建立]

      New Azure SignalR Service instance

    3. 當 [設定 Azure SignalR Service] 畫面顯示時,新的執行個體即會出現在清單中。 選取清單中的新執行個體,然後選取 [下一步]

  7. 輸入連接字串名稱,或選擇預設值,然後選擇您要將連接字串儲存在本機秘密檔案中,還是 Azure Key Vault 中。

    Specify connection string

  8. [變更摘要] 畫面會顯示當您完成程序時,將會對專案進行的所有修改。 如果變更看起來正常,請選擇 [完成]

    Summary of changes

  9. 連線會出現在 [已連線的服務][服務相依性] 區段底下。

    Service dependencies

使用已連線的服務連線到 Azure SignalR

注意

對於 .NET Framework 專案,已連線的服務 UI 稍有不同。 若要了解差異,請與此頁面的 Visual Studio 2019 版本進行比較。

  1. 在 Visual Studio 中,開啟您的專案。

  2. 在 [方案總管] 中,於 [已連線的服務] 節點上按一下滑鼠右鍵,然後從捷徑功能表中選取 [新增] 以開啟可用服務的功能表。

    Screenshot showing Connected Services context menu options.

  3. 選擇 [Azure SignalR Service]。 [連線到相依性] 頁面隨即出現。

    Screenshot showing Connect to dependency for Azure SignalR.

    如果您尚未登入,請登入您的 Azure 帳戶。 如果您沒有 Azure 帳戶,您可以註冊免費試用

  4. 選取現有的 Azure SignalR 元件,然後選取 [下一步]

    如果您需要建立新的元件,請移至下一個步驟。 否則,請跳至步驟 7。

    Screenshot showing

  5. 若要建立 Azure SignalR 服務執行個體:

    1. 選取畫面右側的 [新建]

    2. 填寫 [Azure SignalR Service:新建] 畫面,然後選取 [建立]

      Screenshot showing

    3. 當 [設定 Azure SignalR Service] 畫面顯示時,新的執行個體即會出現在清單中。 選取清單中的新執行個體,然後選取 [下一步]

  6. 輸入連接字串名稱,或選擇預設值,然後選擇您要將連接字串儲存在本機秘密檔案中,還是 Azure Key Vault 中。

    Screenshot showing

  7. [變更摘要] 畫面會顯示當您完成程序時,將會對專案進行的所有修改。 如果變更看起來正常,請選擇 [完成]

    Screenshot showing

  8. 在 [方案總管] 中,按兩下 [已連線的服務] 節點,以開啟 [已連線的服務] 索引標籤。=連線會出現在 [服務相依性] 區段底下:

    Screenshot showing

    如果您按一下您新增的相依性旁的三個點,您可以看到各種選項,例如 [連線] 以重新開啟精靈並變更連線。 您也可以按一下視窗右上方的三個點,以查看啟動本機相依性、變更設定等選項。

下一步

請遵循 Azure SignalR 快速入門以繼續。 您可以略過初始設定 (因為您已經完成),並繼續遵循將 Azure SignalR 新增至 Web 應用程式一節。 您使用的程式碼會根據您的 ASP.NET Core 版本而有所不同,因此,如果您的 ASP.NET Core 版本不符合快速入門中使用的版本,則您可能需要修改教學課程中的程式碼,以使其符合您的專案範本。