使用 Visual Studio,可以使用 Connected Services 功能将以下任一项连接到 Azure SignalR 服务:
- .NET Framework 控制台应用
- ASP.NET 模型View-Controller (MVC) (.NET Framework)
- ASP.NET Core
- .NET Core(包括控制台应用、WPF、Windows 窗体、类库)
- .NET Core 辅助角色
- Azure Functions
- 通用 Windows 平台应用
- Xamarin
- 科尔多瓦
连接的服务功能将所需的所有引用和连接代码添加到项目,并相应地修改配置文件。
先决条件
- 安装有 Azure 工作负荷的 Visual Studio。
- 受支持类型之一的项目
- Azure 帐户。 如果没有 Azure 帐户,请激活你的 Visual Studio 订阅者 Azure 权益或注册免费试用版。
使用连接服务连接到 Azure SignalR
在 Visual Studio 中打开项目。
在 解决方案资源管理器中,右键单击 连接服务 节点,然后在上下文菜单中选择“添加连接服务”。
如果未看到“连接的服务”节点,请选择“项目”>“连接的服务”>“添加”。
在 连接服务 选项卡中,选择 服务依赖项的 +图标。
在 添加依赖项 页中,选择 Azure SignalR 服务。
如果尚未登录,请登录到 Azure 帐户。 如果没有 Azure 帐户,可以注册 免费试用版。
在 配置 Azure SignalR 屏幕中,选择现有的 Azure SignalR 组件,然后选择“下一步”。
如果需要创建新组件,请转到下一步。 否则,请跳到步骤 7。
若要创建 Azure SignalR 服务实例,请执行以下操作:
选择屏幕底部的 创建新的 Azure SignalR 服务实例。
填写“Application SignalR 服务: 新建屏幕,然后选择“创建”。
显示 配置 Azure SignalR 服务 屏幕时,新实例将显示在列表中。 选择列表中的新实例,然后选择“下一步”。
输入连接字符串名称,或选择默认值,并选择是要将连接字符串存储在本地机密文件中,还是 Azure Key Vault中。
“更改摘要”屏幕显示了在完成该过程后将对项目进行的所有修改。 如果更改看起来正常,请选择“完成”。
更改摘要
连接显示在“连接服务”选项卡的“服务依赖项”部分下。
使用连接服务连接到 Azure SignalR
说明
对于 .NET Framework 项目,连接服务 UI 略有不同。 若要查看差异,请与本页的 Visual Studio 2019 版本进行比较。
在 Visual Studio 中打开项目。
在 解决方案资源管理器中,右键单击 连接服务 节点,并从上下文菜单中选择 “添加”以打开可用服务的菜单。
如果未看到“连接的服务”节点,请选择“项目”>“连接的服务”>“添加”。
选择“Azure SignalR 服务”。 随即显示“连接到依赖项”页。
如果尚未登录,请登录到 Azure 帐户。 如果没有 Azure 帐户,可以注册 免费试用版。
选择现有的 Azure SignalR 组件,然后选择 “下一步”。
如果需要创建新组件,请转到下一步。 否则,请跳到步骤 7。
若要创建 Azure SignalR 服务实例,请执行以下操作:
选择屏幕右中部的“新建”。
填写“Application SignalR 服务: 新建屏幕,然后选择“创建”。
显示 配置 Azure SignalR 服务 屏幕时,新实例将显示在列表中。 选择列表中的新实例,然后选择“下一步”。
输入连接设置名称,或接受默认值。
说明
为了提高安全性,在 Visual Studio 17.12 及更高版本中,此步骤将创建连接设置名称;以前的版本创建连接字符串。 存储在本地文件系统中的连接字符串可能会导致安全风险(如果无意中公开)。
单击 其他设置 并选择是想要将连接信息存储在本地机密文件中,还是 Azure Key Vault中。
完成该过程后,更改摘要 屏幕将显示对您的项目所做的所有修改。 如果更改看起来正常,请选择“完成”。
在解决方案资源管理器中,双击 连接服务 节点,打开 连接服务 选项卡。连接显示在 服务依赖项 部分下:
如果单击添加的依赖项旁边的三个点,可以看到各种选项,例如 连接 重新打开向导并更改连接。 还可以单击窗口右上角的三个点,查看用于启动本地依赖项、更改设置等的选项。
后续步骤
按照 Azure SignalR 快速入门继续操作。 可以跳过初始设置,因为已执行此操作,并继续 将 Azure SignalR 添加到 Web 应用部分。 使用的代码因 ASP.NET Core 版本而异,因此,如果 ASP.NET Core 版本与快速入门中使用的版本不匹配,可能需要修改本教程中的代码,以适应项目模板。