ASP.NET Core SignalR 3.1 教程：服务端与客户端实战

“.NetCore SignalR 3.1 简单应用” 本文将详细介绍如何在.NET Core 3.1环境中使用SignalR构建一个简单的实时通信应用。SignalR是ASP.NET Core框架的一部分，专为实时Web功能而设计，使得服务器可以实时地向客户端推送数据，而无需客户端发起新的请求。 SignalR支持多种底层传输技术，包括WebSocket、Server Sent Events (SSE) 和 Long Polling。这些传输方式可以根据服务器和客户端的能力自动选择，确保在各种网络环境下都能实现高效的双向通信。 首先，我们需要创建一个ASP.NET Core 3.1的Web应用程序项目。在创建项目后，需要通过NuGet包管理器安装以下依赖包： 1. Microsoft.AspNetCore.SignalR 2. Microsoft.AspNetCore.SignalR.Client 3. Microsoft.AspNetCore.SignalR.Client.Core 接着，我们将创建一个SignalR的“中心”（Hub）。Hub是SignalR的核心概念，它是一个类，包含了服务器端的方法，这些方法可以直接被客户端调用或由服务器端主动调用到客户端。下面是一个简单的`ServerHub`示例： ```csharp using Microsoft.AspNetCore.SignalR; using Microsoft.Extensions.DependencyInjection; using Newtonsoft.Json; using System; using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; namespace WebApplication3.ServerHub { public class ServerHub : Hub { private readonly IServiceProvider _serviceProvider; public ServerHub(IServiceProvider serviceProvider) { _serviceProvider = serviceProvider; } // 在此处定义你的服务器端方法，例如： public async Task SendMessageToAll(string user, string message) { await Clients.All.SendAsync("ReceiveMessage", user, message); } } } ``` 在上面的代码中，我们定义了一个名为`SendMessageToAll`的方法，它接受两个参数，然后调用客户端上名为`ReceiveMessage`的方法，将消息广播给所有连接到此Hub的客户端。 接下来，我们需要在`Startup.cs`文件中的`ConfigureServices`方法中注册SignalR服务，并在`Configure`方法中设置路由，以便客户端可以找到SignalR的Hub： ```csharp public void ConfigureServices(IServiceCollection services) { services.AddSignalR(); } public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { // 其他配置... app.UseRouting(); app.UseEndpoints(endpoints => { endpoints.MapHub<ServerHub>("/serverHub"); }); } ``` 配置完成后，我们可以编写客户端代码来连接到SignalR Hub并监听服务器的事件。在JavaScript中，你可以使用`HubConnectionBuilder`来创建连接并订阅服务器的方法： ```javascript const connection = new signalR.HubConnectionBuilder() .withUrl("/serverHub") .build(); connection.start().catch(err => console.error(err.toString())); connection.on("ReceiveMessage", (user, message) => { console.log(`用户${user}发送的消息：${message}`); }); ``` 最后，当服务器端调用`SendMessageToAll`方法时，所有已连接的客户端都会接收到`ReceiveMessage`事件并显示相应消息。 .NET Core SignalR 3.1使得在Web应用中实现实时通信变得非常简单。无论是实时聊天、股票更新还是游戏状态同步，SignalR都可以帮助开发者高效地处理这些场景，极大地提升了用户体验。