使用 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
在 Visual Studio 中開啟您的專案。
在 [方案總管]中,以滑鼠右鍵按兩下 [連線服務] 節點,然後從操作功能表中選取 [[新增已連線的服務]。
如果您沒有看到 [連線服務] 節點,請選擇 [專案>連線服務]>[新增]。
在 [連線服務] 索引標籤中,選取 [服務相依性的 + 圖示。
在 [新增相依性] 頁面中,選取 [Azure SignalR Service]。
如果您尚未登入,請登入您的 Azure 帳戶。 如果您沒有 Azure 帳戶,您可以註冊 免費試用。
在 [設定 Azure SignalR 畫面] 中,選取現有的 Azure SignalR 元件,然後選取 [下一步]。
如果您需要建立新的元件,請移至下一個步驟。 否則,請跳至步驟 7。
若要建立 Azure SignalR 服務實例:
選取 [在畫面底部建立新的 Azure SignalR Service 實例。
填寫 azure SignalR Service:建立新的 畫面,然後選取 [建立 建立]。
當 [設定 Azure SignalR Service] 畫面顯示時,新的實例會出現在清單中。 在清單中選擇新實體,然後選擇 [下一步]。
輸入連接字串名稱,或選擇預設值,然後選擇您要將連接字串儲存在本機秘密檔案中,還是 Azure Key Vault中。
變更摘要 畫面會顯示如果您完成此過程,將會對專案進行的所有修改。 如果變更看起來正常,請選擇 完成。
在 [連線服務] 標籤的 [依存的服務] 部分中顯示聯機。
使用已連線的服務連線到 Azure SignalR
注意
對於 .NET Framework 專案,連線服務 UI 稍有不同。 若要查看差異,請與此頁面的 Visual Studio 2019 版本進行比較。
在 Visual Studio 中開啟您的專案。
在 [方案總管]中,以滑鼠右鍵按兩下 [連線服務] 節點,然後從操作功能表中選取 [新增],以開啟可用服務的功能表。
如果您沒有看到 [連線服務] 節點,請選擇 [專案>連線服務]>[新增]。
選擇 Azure SignalR Service。 [連線到相依性] 頁面隨即出現。
如果您尚未登入,請登入您的 Azure 帳戶。 如果您沒有 Azure 帳戶,您可以註冊 免費試用。
選取現有的 Azure SignalR 元件,然後選取 [下一步]。
如果您需要建立新的元件,請移至下一個步驟。 否則,請跳至步驟 7。
若要建立 Azure SignalR 服務實例:
選取 在畫面右側建立新的。
填寫 Azure SignalR 服務:建立 畫面,然後選取 [建立 ]。
當 [設定 Azure SignalR Service] 畫面顯示時,新的實例會出現在清單中。 選取清單中的新實例,然後選取 [下一步]。
輸入連線設定名稱,或接受預設值。
注意
為了改善安全性,在 Visual Studio 17.12 和更新版本中,此步驟會建立連線設定名稱;舊版會建立連接字串。 儲存在本機文件系統中的連接字串可能會導致安全性風險,如果意外公開。
按兩下 [[其他設定],然後選擇您要將連線資訊儲存在本機秘密檔案中,還是 Azure Key Vault。
變更摘要 畫面會顯示如果您完成流程,將對您的專案進行的所有修改。 如果變更看起來正常,請選擇「完成」。
在 [方案總管] 中,按兩下 [已連線服務] 節點,以開啟 [已連線服務] 索引標籤。此連線將顯示在 [服務依存關係] 區段下:
如果您按下所新增相依性旁的三個點,您可以看到各種選項,例如 Connect 重新開啟精靈並變更連線。 您也可以按下視窗右上方的三個點,以查看啟動本地依賴項、變更設定等選項。
後續步驟
請繼續按照 Azure SignalR 快速入門進行。 您可以略過初始設定,因為您已經這麼做,然後繼續進行 將 Azure SignalR 新增至 Web 應用程式一節。 您使用的程式代碼會根據您的 ASP.NET Core 版本而有所不同,因此,如果您的 ASP.NET Core 版本不符合快速入門中使用的版本,您可能需要修改教學課程中的程式代碼,以符合您的專案範本。