共用方式為


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

使用 Visual Studio,您可以使用 Connected Services 功能,將下列任一項連線至 Azure SignalR 服務:

  • .NET Framework 控制台應用程式
  • ASP.NET 模型-View-Controller (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (包括控制台應用程式、WPF、Windows Forms、類別庫)
  • .NET Core 背景工作角色
  • Azure Functions
  • 通用 Windows 平台應用程式
  • Xamarin
  • 科爾多瓦

線上的服務功能會將所有必要的參考和連線程式代碼新增至專案,並適當地修改組態檔。

先決條件

  • 已安裝 Azure 工作負載的 Visual Studio。
  • 某一個支持類型的專案
  • Azure 帳戶。 如果您沒有 Azure 帳戶,請先啟用適用於 Visual Studio 訂閱者的 Azure 權益,或者 註冊免費試用

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

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

  2. [方案總管]中,以滑鼠右鍵按兩下 [連線服務] 節點,然後從操作功能表中選取 [[新增已連線的服務]

    如果您沒有看到 [連線服務] 節點,請選擇 [專案>連線服務]>[新增]。

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

    新增服務相依性

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

    新增 Azure SignalR Service

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

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

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

    連線到現有的 Azure SignalR 元件

  6. 若要建立 Azure SignalR 服務實例:

    1. 選取 [在畫面底部建立新的 Azure SignalR Service 實例

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

      新的 Azure SignalR Service 實例

    3. [設定 Azure SignalR Service] 畫面顯示時,新的實例會出現在清單中。 在清單中選擇新實體,然後選擇 [下一步]

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

    指定連接字串

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

    變更摘要

  9. 在 [連線服務] 標籤的 [依存的服務] 部分中顯示聯機。

    服務相依性

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

注意

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

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

  2. [方案總管]中,以滑鼠右鍵按兩下 [連線服務] 節點,然後從操作功能表中選取 [新增],以開啟可用服務的功能表。

    顯示「連線服務」內容功能表選項的螢幕快照。

    如果您沒有看到 [連線服務] 節點,請選擇 [專案>連線服務]>[新增]。

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

    顯示連線至 Azure SignalR 相依性螢幕快照。

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

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

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

    顯示「連線到現有 Azure SignalR 元件」畫面截圖。

  5. 若要建立 Azure SignalR 服務實例:

    1. 選取 在畫面右側建立新的

    2. 填寫 Azure SignalR 服務:建立 畫面,然後選取 [建立 ]。

      顯示 [新增 Azure SignalR Service 實例] 畫面的螢幕快照。

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

  6. 輸入連線設定名稱,或接受預設值。

    顯示 [指定連接字串] 畫面的螢幕快照。

    注意

    為了改善安全性,在 Visual Studio 17.12 和更新版本中,此步驟會建立連線設定名稱;舊版會建立連接字串。 儲存在本機文件系統中的連接字串可能會導致安全性風險,如果意外公開。

  7. 按兩下 [[其他設定],然後選擇您要將連線資訊儲存在本機秘密檔案中,還是 Azure Key Vault

    顯示其他設定的螢幕快照,其中包含儲存連線設定的選項。

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

    顯示 [變更摘要] 畫面的螢幕快照。

  9. 在 [方案總管] 中,按兩下 [已連線服務] 節點,以開啟 [已連線服務] 索引標籤。此連線將顯示在 [服務依存關係] 區段下:

    顯示 [服務相依性] 區段的螢幕快照。

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

後續步驟

請繼續按照 Azure SignalR 快速入門進行。 您可以略過初始設定,因為您已經這麼做,然後繼續進行 將 Azure SignalR 新增至 Web 應用程式一節。 您使用的程式代碼會根據您的 ASP.NET Core 版本而有所不同,因此,如果您的 ASP.NET Core 版本不符合快速入門中使用的版本,您可能需要修改教學課程中的程式代碼,以符合您的專案範本。