使用 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 平台应用
  • Xamarin
  • Cordova

连接服务功能可将所有需要的引用和连接代码添加到项目,并相应地修改配置文件。

注意

本主题适用于 Visual Studio Windows 版。 有关 Visual Studio for Mac,请参阅 Visual Studio for Mac 中连接服务

先决条件

使用连接的服务连接到 Azure SignalR

  1. 在 Visual Studio 中打开项目。

  2. 在“解决方案资源管理器”中,右键单击“连接服务”节点,并在上下文菜单中选择“添加连接服务”。

  3. 在“连接服务”选项卡中,选择“服务依赖项”的 + 图标。

    Add Service Dependency

  4. 在“添加依赖项”页中,选择“Azure SignalR 服务”。

    Add Azure SignalR Service

    如果还没有登录,请登录到 Azure 帐户。 如果没有 Azure 帐户,可以注册免费试用版

  5. 在“配置 Azure SignalR”屏幕中,选择现有 Azure SignalR 组件,然后选择“下一步”。

    如果需要创建新组件,请转到下一步。 否则,请跳到步骤 7。

    Connect to existing Azure SignalR component

  6. 创建 Azure SignalR 服务实例:

    1. 选择屏幕底部的”创建新的 Azure SignalR 服务实例”。

    2. 填写“Application SignalR 服务: 新建屏幕,然后选择“创建”。

      New Azure SignalR Service instance

    3. 当显示“配置 Azure SignalR 服务”屏幕时,新实例将出现在列表中。 在列表中选择新实例,并选择“下一步”。

  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 服务”。 随即显示“连接到依赖项”页。

    Screenshot showing Connect to dependency for Azure SignalR.

    如果还没有登录,请登录到 Azure 帐户。 如果没有 Azure 帐户,可以注册免费试用版

  4. 选择现有 Azure SignalR 组件,然后选择“下一步”。

    如果需要创建新组件,请转到下一步。 否则,请跳到步骤 7。

    Screenshot showing

  5. 创建 Azure SignalR 服务实例:

    1. 选择屏幕右中部的“新建”。

    2. 填写“Application SignalR 服务: 新建屏幕,然后选择“创建”。

      Screenshot showing

    3. 当显示“配置 Azure SignalR 服务”屏幕时,新实例将出现在列表中。 在列表中选择新实例,并选择“下一步”。

  6. 输入连接字符串名称或选择默认值,然后选择是希望连接字符串存储在本地机密文件中,还是存储在 Azure Key Vault 中。

    Screenshot showing

  7. “更改摘要”屏幕显示了在完成该过程后将对项目进行的所有修改。 如果更改看起来正常,请选择“完成”。

    Screenshot showing

  8. 在“解决方案资源管理器”中,双击“连接的服务”节点以打开“连接的服务”选项卡。连接显示在“服务依赖项”部分下:

    Screenshot showing

    如果单击添加的依赖项旁边的三个点,可以看到各种选项(例如“连接”)以重新打开向导并更改连接。 还可以单击窗口右上角的三个点,查看用于启动本地依赖项、更改设置等的选项。

后续步骤

按照 Azure SignalR 快速入门继续操作。 可以跳过初始设置(因为已执行此操作),然后继续执行将 Azure SignalR 添加到 Web 应用部分。 使用的代码因 ASP.NET Core 版本而异,因此,如果 ASP.NET Core 版本与快速入门中使用的版本不匹配,可能就需要根据项目模板修改教程中的代码。