如何在.NET中集成SignalR

SignalR 简介

SignalR是一个开放源代码库,可用于简化向应用添加实时Web功能,实时Web功能使服务器端代码能够将内容推送到客户端。

SignalR开源库:https://github.com/SignalR/SignalR

SignalR 应用场景

需要高频次从服务器获取信息的应用:如预警、游戏、社交网络、投票、拍卖、地图和GPS引用;

仪表盘应用:如数字大屏、仪表板、即时信息看板等;

协作应用:包括白板应用和团队会议软件;

通知应用:社交网络、电子邮件、聊天、游戏、预警和其他应用都需要使用的通知。

.NET Framework项目中集成SignalR

服务端(.NET Framework MVC)

选择要引用Signalr的项目,右键点击【管理NuGet程序包】搜索【SignalR】包,找到" Microsoft.AspNet.SignalR ",点击【安装】

因为SignalR需要依赖其他程序包,在安装" Microsoft.AspNet.SignalR "的同时,还会自动安装" Microsoft.AspNet.SignalR.Core "、" Microsoft.AspNet.SignalR.JS "、" Microsoft.AspNet.SignalR.SystemWeb "。

还需引用添加Owin相关的包,Owin定义了 Web 服务器和应用程序组件之间的交互的规范。

同样,在【管理NuGet程序包】搜索【Owin】包,找到" Microsoft.Owin ",点击【安装】

在项目中引入

复制代码
Microsoft.Owin.Hosting
Microsoft.Owin.Cors
Microsoft.Owin.Host.HttpListener

在Web项目中【Startup.cs】文件中启用SignalR。

复制代码
 public class Startup
    {
        public void Configuration(IAppBuilder app)
        {
            app.MapSignalR();
       }
    }

创建一个类来继承Hub类

复制代码
    public class ServerHub : Hub
    {       
        public async Task DoWork()
        {
            //供客户端调用
        }
        public async Task SendMessage(string msg)
        {
            // 当前连接用户的标志,是一个GUID,如:362d3597-041e-4d65-8fdf-e77e98425d38
            string connectionId = Context.ConnectionId;
            // 给所有人发送消息
            await Clients.All(connectionId).newmsg(msg);
            // 给组内所有人发送消息
            await Clients.Group(connectionId).newmsg(msg);
            // 给除去自己其他人发送消息
            await Clients.Others(connectionId).newmsg(msg);
            // 给自己发送消息
            await Clients.Caller(connectionId).newmsg(msg);
        }

        public async Task WhoIam(string connectionId)
        {
            // 当前连接用户的标志,是一个GUID,如:362d3597-041e-4d65-8fdf-e77e98425d38
            await Groups.Add(Context.ConnectionId, connectionId);
            await Clients.Group(connectionId).newmsg(Context.ConnectionId + "已登入");
        }
    }

BuildHub中的方法供客户端调用,方法中Clients代表客户端对象。

把后台服务启动起来,然后查看SignalR状态是否正常,如果出现如图页面则表示SignalR正常。

客户端:

在网页中引入SignalR相关JS

复制代码
  <script src="/Scripts/jquery.min.js"></script>
  <script src="/Scripts/jquery.signalR-2.4.1.min.js"></script>
  <script src="/signalr/hubs"></script>

客户端页面代码:

复制代码
<html>
<head>
    <title>SignalR</title>
</head>
<body>
    <div> 
        <input type="text" id="msg"/>
        <button id="sendMsg">发送消息</button>
    </div>
    <ol id="showMsg"></ol>  
  <script src="/Scripts/jquery.min.js"></script>
  <script src="/Scripts/jquery.signalR-2.4.1.min.js"></script>
  <script src="/signalr/hubs"></script>
    <script>
        $(function () {
            //获取服务端连接对象
            var hub = $.connection.serverHub;
            //创建服务端所调用的客户端方法
            hub.client.showMsg=function(name, msg){
                $('#showMsg').append('<li><span style="color:red">'+name+':</span>'+msg+'</li>')
            }
            //开始连接服务器
            $.connection.hub.start().done(function () {
                //连接成功
                $('#sendMsg').bind('click', function () {
                    //调用服务端发送方法
                    hub.server.SendMessage($('#msg').val());
                })
            }).fail(function () {
                //连接失败
                alert("连接失败");
            });
        })
</script>
</body>
</html>

.NET Core 中集成 SignalR

先通过【管理 NuGet 程序包】搜索、安装 SignalR 包,主要是配置上有点差异。

若项目是.NET6 以前的版本,在【Startup.cs】中配置:

复制代码
    public class Startup
    {
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllers();
            services.AddSignalR();
        }
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            app.UseRouting();
            app.UseAuthorization();
            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllers();
                endpoints.MapHub("Hubs"); 
            });
        }
    }

若项目是.NET6 以后的版本,则在【Program.cs】中配置:

复制代码
var builder = WebApplication.CreateBuilder(args);
//添加 SignalR 服务
builder.Services.AddSignalR();
app.UseEndpoints(endpoints =>
{
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Home}/{action=Index}/{id?}"
    );
    //添加 SignalR 端点
    endpoints.MapHub("/Hubs");
});

来源: 如何在.NET中集成SignalR-武穆逸仙

相关推荐
PascalMing6 小时前
openEuler 25.09 安装 .NET 10(二进制 tar.gz 包)教程
.net·openeuler
我是唐青枫7 小时前
C#.NET ReaderWriterLockSlim 深入解析:读写锁原理、升级锁与使用边界
开发语言·c#·.net
学以智用8 小时前
.NET Core 日志与异常管理 完整实战指南
后端·.net
SEO-狼术10 小时前
Capture Freehand Ink Annotations in PDFs
pdf·.net
SEO-狼术11 小时前
Plan Projects Easily with Built-in Gantt Tools
pdf·.net
唐青枫21 小时前
C#.NET ReaderWriterLockSlim 深入解析:读写锁原理、升级锁与使用边界
c#·.net
蒙塔基的钢蛋儿1 天前
告别内存泄露与空指针:用C#与.NET 10开启STM32H7高性能单片机开发新纪元
stm32·c#·.net
时光追逐者1 天前
一款基于 .NET 开源、跨平台应用程序自动升级组件
c#·.net·.net core
海盗12341 天前
ScottPlot在WPF的基本使用和中文乱码问题
c#·.net·wpf