C# 如何使用 SignalR 实现实时通信_C# SignalR 实时通信开发指南

畫卷琴夢
发布: 2025-11-16 15:18:06
原创
384人浏览过
SignalR是ASP.NET提供的实时通信库,通过Hub模型实现服务器主动推送。首先创建ChatHub类处理消息,注册SignalR服务并映射/chathub路由,客户端使用HubConnection连接,调用InvokeAsync发送消息,On接收消息,支持分组、认证和重连机制,适用于聊天、通知等场景。

c# 如何使用 signalr 实现实时通信_c# signalr 实时通信开发指南

SignalR 是 ASP.NET 提供的一个强大库,用于简化服务器与客户端之间的实时通信。使用 C# 和 SignalR,你可以轻松实现聊天应用、实时通知、数据仪表盘等需要即时更新的功能。下面是一个实用的开发指南,帮助你快速上手 C# 中的 SignalR 实现。

1. 什么是 SignalR?

SignalR 是一个开源库,允许服务器主动向连接的客户端推送信息。它自动选择最佳通信方式(如 WebSockets、Server-Sent Events 或长轮询),开发者无需关心底层协议切换。

核心特点包括:

  • 自动连接管理
  • 支持多种客户端(浏览器、移动端、桌面应用)
  • 简单易用的 Hub 模型进行方法调用

2. 创建 SignalR 服务端(ASP.NET Core)

以 ASP.NET Core 项目为例,搭建一个基础的 SignalR 服务。

步骤 1:安装 NuGet 包

在项目中安装 SignalR 服务端包:

dotnet add package Microsoft.AspNetCore.SignalR
登录后复制

步骤 2:创建 Hub 类

Hub 是 SignalR 的核心类,负责处理客户端请求和广播消息。

新建一个类继承 Hub

using Microsoft.AspNetCore.SignalR;
<p>public class ChatHub : Hub
{
public async Task SendMessage(string user, string message)
{
await Clients.All.SendAsync("ReceiveMessage", user, message);
}
}</p>
登录后复制

步骤 3:注册 SignalR 服务和路由

Program.cs 中配置服务和中间件:

var builder = WebApplication.CreateBuilder(args);
<p>// 添加 SignalR 服务
builder.Services.AddSignalR();</p><p>var app = builder.Build();</p><p>app.UseRouting();</p><p>// 映射 Hub 路由
app.MapHub<ChatHub>("/chathub");</p><p>app.Run();</p>
                    <div class="aritcle_card">
                        <a class="aritcle_card_img" href="/ai/950">
                            <img src="https://img.php.cn/upload/ai_manual/000/000/000/175680003823895.png" alt="ViiTor实时翻译">
                        </a>
                        <div class="aritcle_card_info">
                            <a href="/ai/950">ViiTor实时翻译</a>
                            <p>AI实时多语言翻译专家!强大的语音识别、AR翻译功能。</p>
                            <div class="">
                                <img src="/static/images/card_xiazai.png" alt="ViiTor实时翻译">
                                <span>116</span>
                            </div>
                        </div>
                        <a href="/ai/950" class="aritcle_card_btn">
                            <span>查看详情</span>
                            <img src="/static/images/cardxiayige-3.png" alt="ViiTor实时翻译">
                        </a>
                    </div>
                
登录后复制

3. 客户端连接 SignalR(C# 控制台或 WPF 示例)

你可以使用 .NET 客户端连接到 SignalR 服务,比如控制台程序或 WPF 应用。

安装客户端包

dotnet add package Microsoft.AspNetCore.SignalR.Client
登录后复制

连接并接收消息

using Microsoft.AspNetCore.SignalR.Client;
<p>var connection = new HubConnectionBuilder()
.WithUrl("<a href="https://www.php.cn/link/7b7114a49b5827132d6097582ec1722d">https://www.php.cn/link/7b7114a49b5827132d6097582ec1722d</a>")
.Build();</p><p>// 接收服务端推送的消息
connection.On<string, string>("ReceiveMessage", (user, message) =>
{
Console.WriteLine($"{user}: {message}");
});</p><p>await connection.StartAsync();</p><p>// 发送消息
await connection.InvokeAsync("SendMessage", "Alice", "Hello World!");</p>
登录后复制

4. 常见应用场景与技巧

SignalR 不仅限于聊天功能,还可用于多种实时场景。

分组通信

将用户加入特定组,实现定向广播:

public override async Task OnConnectedAsync()
{
    await Groups.AddToGroupAsync(Context.ConnectionId, "NewsGroup");
}
<p>// 向组内所有成员发送消息
await Clients.Group("NewsGroup").SendAsync("NewArticle", title);</p>
登录后复制

身份验证

通过 JWT 或 Cookie 验证用户身份,Hub 中可访问 Context.User 获取用户信息。

确保在客户端连接时传递 token:

.WithUrl("https://www.php.cn/link/7b7114a49b5827132d6097582ec1722d", options =>
{
    options.AccessTokenProvider = () => Task.FromResult("your-jwt-token");
})
登录后复制

错误处理与重连

添加重连逻辑提升稳定性:

connection.Closed += async (error) =>
{
    await Task.Delay(5000);
    await connection.StartAsync();
};
登录后复制

基本上就这些。SignalR 极大地简化了实时通信的开发流程,配合 C# 的强类型优势,能快速构建稳定高效的实时应用。只要理解 Hub 模型和客户端交互方式,就能灵活应用于各种业务场景。不复杂但容易忽略细节,比如连接生命周期管理和异常处理,建议结合日志监控完善健壮性。

以上就是C# 如何使用 SignalR 实现实时通信_C# SignalR 实时通信开发指南的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号