使用Blazor Server 线路处理程序 (circuit handler)跟踪打开的SignalR连接

Blazor服务器允许定义线路处理程序(circuit handler)代码，该处理程序(handler)允许在更改用户线路状态时运行此代码。 线路处理程序(circuit handler)是通过从CircuitHandler类派生并在应用程序的服务容器中注册该类来实现的。

以下线路处理程序(circuit handler)示例跟踪打开的SignalR连接：

 using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.AspNetCore.Components.Server.Circuits;

 public class TrackingCircuitHandler : CircuitHandler
 {
     private HashSet<Circuit> _circuits = new HashSet<Circuit>();

     public override Task OnConnectionUpAsync(Circuit circuit,
         CancellationToken cancellationToken)
     {
         _circuits.Add(circuit);

         return Task.CompletedTask;
     }

     public override Task OnConnectionDownAsync(Circuit circuit,
         CancellationToken cancellationToken)
     {
         _circuits.Remove(circuit);

         return Task.CompletedTask;
     }

     public int ConnectedCircuits => _circuits.Count;
 }

线路处理程序使用DI (依赖注入) 注册。 每个线路实例都会创建作用域实例。 在前面的示例中使用TrackingCircuitHandler来创建单例服务，因为必须跟踪所有电路的状态：

 public void ConfigureServices(IServiceCollection services)
 {
     ...
     services.AddSingleton<CircuitHandler, TrackingCircuitHandler>();
 }

如果自定义线路处理程序(circuit handler)的方法抛出未处理的异常，则该异常对于Blazor Server线路是致命的。 要容忍处理程序代码或被调用方法中的异常，请使用错误处理和日志记录将代码包装在一个或多个try-catch语句中。

当由于用户断开连接而线路结束并且框架正在清除线路状态时，框架将处理线路的DI(依赖注入)范围。 处置范围处置任何实现System.IDisposable的线路范围的DI服务。 如果有任何DI服务在处理期间引发未处理的异常，则框架记录该异常。