悠悠楠杉
网站页面
C如何使用SignalR实现实时通信
11/28
![]()
在现代 Web 应用开发中，实时通信已成为提升用户体验的关键技术之一。无论是在线聊天、实时通知，还是数据仪表盘的动态更新，用户都期望信息能够即时传递。在 .NET 生态中，SignalR 是实现实时双向通信的首选框架。它封装了 WebSocket、Server-Sent Events 和长轮询等多种底层技术，让开发者可以专注于业务逻辑，而无需关心传输细节。
SignalR 的核心机制基于“Hub”模式。Hub 是一个位于服务端的类，充当客户端与服务器之间的通信中心。通过继承 Hub 基类，我们可以定义可被客户端调用的方法，也可以从服务端主动向客户端推送消息。这种双向通信能力极大简化了实时功能的实现。
要在 C# 项目中使用 SignalR，首先需要创建一个 ASP.NET Core Web 应用程序。通过 NuGet 安装 Microsoft.AspNetCore.SignalR 包后，即可开始配置。在 Program.cs 中添加 SignalR 服务支持：
csharp
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddSignalR();
接着，映射 Hub 的路由：
csharp
var app = builder.Build();
app.MapHub<ChatHub>("/chat");
app.Run();
接下来，创建一个名为 ChatHub 的 Hub 类：
csharp
public class ChatHub : Hub
{
public async Task SendMessage(string user, string message)
{
await Clients.All.SendAsync("ReceiveMessage", user, message);
}
}
在这个例子中，SendMessage 方法由客户端调用，而 Clients.All.SendAsync 则将消息广播给所有已连接的客户端。ReceiveMessage 是客户端需要监听的回调方法名。整个过程无需手动管理连接状态，SignalR 自动处理客户端的加入、离开和异常断开。
在前端，SignalR 提供了 JavaScript 客户端库。引入 @microsoft/signalr 后，可以轻松建立连接：
javascript
const connection = new signalR.HubConnectionBuilder()
.withUrl("/chat")
.build();
connection.start().then(function () {
console.log("连接成功");
}).catch(function (err) {
console.error(err.toString());
});
connection.on("ReceiveMessage", function (user, message) {
const msg = document.createElement("div");
msg.textContent = ${user}: ${message};
document.getElementById("messages").appendChild(msg);
});
当用户发送消息时，前端调用：
javascript
connection.invoke("SendMessage", "张三", "你好！");
这会触发服务端的 SendMessage 方法，并将结果推送给所有客户端。
除了广播，SignalR 还支持更精细的消息控制。例如，Clients.Caller 只回复调用者，Clients.Others 发送给除自己外的所有人，Clients.Client(connectionId) 可定向发送给特定连接。此外，还可以通过分组（Group）机制实现频道式通信，比如将用户加入“订单通知”组，仅接收相关更新。
安全性方面，SignalR 支持与 ASP.NET Core 的身份验证机制无缝集成。通过 [Authorize] 特性，可以限制 Hub 或特定方法的访问权限，确保只有合法用户才能参与实时通信。
性能上，SignalR 默认优先使用 WebSocket，提供低延迟、高吞吐的通信能力。即使在不支持 WebSocket 的环境中，它也能自动降级到 Server-Sent Events 或长轮询，保证功能可用性。
总之，SignalR 极大地降低了 C# 开发者构建实时应用的门槛。无论是简单的通知系统，还是复杂的多人协作工具，SignalR 都能提供稳定、高效、易维护的通信基础。结合 ASP.NET Core 的现代化架构，它已成为企业级实时应用开发的标配工具。
