【下载文档:  详解在asp.net框架Core下使用SignalR技术.txt 】

---

详解在ASP.NET Core下使用SignalR技术
一、前言
上次我们讲到过如何在ASP.NET Core中使用WebSocket 。这次的主角是SignalR它为我们提供了简化操作WebSocket的框架。
ASP .NET SignalR 是一个ASP.NET 下的类库，可以在ASP.NET 的Web项目中实现实时通信。什么是实时通信的Web呢？就是让客户端（Web页面）和服务器端可以互相通知消息及调用方法，当然这是实时操作的。WebSockets是HTML5提供的新的API，可以在Web网页与服务器端间建立Socket连接，当WebSockets可用时（即浏览器支持Html5）SignalR使用WebSockets，当不支持时SignalR将使用其它技术来保证达到相同效果。
SignalR当然也提供了非常简单易用的高阶API，使服务器端可以单个或批量调用客户端上的JavaScript函数，并且非常 方便地进行连接管理，例如客户端连接到服务器端，或断开连接，客户端分组，以及客户端授权，使用SignalR都非常容易实现。
二、SignalR目前情况
我们知道在ASP.NET Core 1.0.x 版本中并没有包含SignalR，但是SignalR技术计划集成在ASP.NET Core 1.2版本中，并且它的开发团队还要使用TypeScript对它的javascript客户端进行重写，服务端方面也会贴近ASP.NET Core的开发方式，比如会集成到ASP.NET Core依赖注入框架中。
目前的情况就是在1.0中无法使用SignalR技术，本文实现的Demo都是在1.1下进行的。
三、集成SignalR
当然ASP.NET Core 1.2离正式发布还有一段时间，目前想集成SignalR都不是现成的方案，我们要通过手动的方式集成SignalR。
要在ASP.NET Core中使用SignalR，要先引用Microsoft.AspNetCore.SignalR.Server 、 Microsoft.AspNetCore.WebSockets 的NuGet Package包。
当然上面也说过目前没有ASP.NET Core没有集成SignalR，所以NUGET上也找不到SignalR的程序包，想添加引用我们就得去MyGet上去找找。
1.添加NuGet源
在程序根目录新建一个命为NuGet.Config的文件内容如下：








当然我们也可以通过在Visual Studio中设置 NuGet Packages的源，来引用这个程序集。
2.在project.json添加引用
"MicrosoftAspNetCoreSignalRServer": "0-*",
"MicrosoftAspNetCoreWebSockets": "0-*"
可以注意到SignalR的版本是0.2.0的alpha版本，所以后续版本可能变化也会比较大！ 听说是好重写的。
值得注意的是，SignalR目前只能在ASP.NET Core 1.1及以上版本上使用，在这个文章中我使用的.NET Core SDK版本为 1.0.0-preview2-003131 ，所以引用有问题的同学可以尝试把CoreApp版本改为1.1，所有AspNetCore的程序集也都改变为1.1的版本。
3.添加配置代码
我们需要在Startup类中的 ConfigureServices方法中添加如下代码：
public void ConfigureServices(IServiceCollection services)
{
servicesAddSignalR(options =>
{
optionsHubsEnableDetailedErrors = true;
});
}
在Startup类中的Configure方法中添加如下代码：
appUseWebSockets();
appUseSignalR();
4.添加一个HUB类
这里我们只实现一个小Demo，一个简单的聊天室，多个人进入可以看到各自发送的信息：
public class ChatHub : Hub
{
public static List ConnectedUsers;
public void Send(string originatorUser, string message)
{
ClientsAllmessageReceived(originatorUser, message);
}
public void Connect(string newUser)
{
if (ConnectedUsers == null)
ConnectedUsers = new List();
ConnectedUsersAdd(newUser);
ClientsCallergetConnectedUsers(ConnectedUsers);
ClientsOthersnewUserAdded(newUser);
}
}
5.客户端支持
在wwwroot目录下创建一个名为chat.html的Html静态文件，内容如下：

同目录下建立一个chat.js添加要实现功能的脚本：
var userName = prompt("Enter your name: ");
var chat = $connectionchatHub;
chatclientmessageReceived = function (originatorUser, message) {
$("#messages")append('

' + originatorUser + ': ' + message);
};
chatclientgetConnectedUsers = function (userList) {
for (var i = 0; i < userListlength; i++)
addUser(userList[i]);
};
chatclientnewUserAdded = function (newUser) {
addUser(newUser);
}
$("#messageBox")focus();
$("#sendMessage")click(function () {
chatserversend(userName, $("#messageBox")val());
$("#messageBox")val("");
$("#messageBox")focus();
});
$("#messageBox")keyup(function (event) {
if (eventkeyCode == 13)
$("#sendMessage")click();
});
function addUser(user){
$("#userList")append('

' + user + '

');
}
$connectionhublogging = true;
$connectionhubstart()done(function () {
chatserverconnect(userName);
});
最后我们来运行它吧：
四、最后
附上一个可用的Demo：http://xiazai.zwyuanma.com/201702/yuanma/AspNetCore.SignalRDemo_jb51.rar
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持中文源码网。