ハブの外部からメッセージを送信する

SignalR ハブは、SignalR サーバーに接続されているクライアントにメッセージを送信するための中核となる抽象化です。 また、IHubContext サービスを使ってアプリ内の他の場所からメッセージを送信することもできます。 この記事では、SignalRIHubContext にアクセスしてハブの外部からクライアントに通知を送信する方法について説明します。

サンプル コードを表示またはダウンロードします (ダウンロード方法)。

IHubContext のインスタンスを取得する

ASP.NET Core SignalR では、依存関係の挿入を介して IHubContext のインスタンスにアクセスできます。 コントローラーやミドルウェアなどの DI サービスに IHubContext のインスタンスを挿入することができます。 そのインスタンスを使ってクライアントにメッセージを送信します。

コントローラーに IHubContext のインスタンスを挿入する

コントローラーに IHubContext のインスタンスを挿入するには、コンストラクターに追加します。

public class HomeController : Controller
{
    private readonly IHubContext<NotificationHub> _hubContext;

    public HomeController(IHubContext<NotificationHub> hubContext)
    {
        _hubContext = hubContext;
    }
}

IHubContext のインスタンスにアクセスして、そのハブ内からのようにクライアント メソッドを呼び出します。

public async Task<IActionResult> Index()
{
    await _hubContext.Clients.All.SendAsync("Notify", $"Home page loaded at: {DateTime.Now}");
    return View();
}

ミドルウェアで IHubContext のインスタンスを取得する

次のように、ミドルウェア パイプライン内で IHubContext にアクセスします。

app.Use(async (context, next) =>
{
    var hubContext = context.RequestServices
                            .GetRequiredService<IHubContext<ChatHub>>();
    //...
    
    if (next != null)
    {
        await next.Invoke();
    }
});

IHost から IHubContext のインスタンスを取得する

Web ホストから IHubContext にアクセスする方法は、サードパーティの依存関係の挿入フレームワークを使うなど、ASP.NET Core の外部にある領域と統合する場合に便利です。

    public class Program
    {
        public static void Main(string[] args)
        {
            var host = CreateHostBuilder(args).Build();
            var hubContext = host.Services.GetService(typeof(IHubContext<ChatHub>));
            host.Run();
        }

        public static IHostBuilder CreateHostBuilder(string[] args) =>
            Host.CreateDefaultBuilder(args)
                .ConfigureWebHostDefaults(webBuilder => {
                    webBuilder.UseStartup<Startup>();
                });
    }

厳密に型指定された HubContext を挿入する

厳密に型指定された HubContext を挿入するには、ハブが Hub<T> から継承されていることを確認します。 IHubContext<THub> ではなく IHubContext<THub, T> インターフェイスを使って挿入します。

public class ChatController : Controller
{
    public IHubContext<ChatHub, IChatClient> _strongChatHubContext { get; }

    public ChatController(IHubContext<ChatHub, IChatClient> chatHubContext)
    {
        _strongChatHubContext = chatHubContext;
    }

    public async Task SendMessage(string user, string message)
    {
        await _strongChatHubContext.Clients.All.ReceiveMessage(user, message);
    }
}

詳細については、「厳密に型指定されたハブ」を参照してください。

class MyHub : Hub
{ }

class MyOtherHub : Hub
{ }

app.Use(async (context, next) =>
{
    var myHubContext = context.RequestServices
                            .GetRequiredService<IHubContext<MyHub>>();
    var myOtherHubContext = context.RequestServices
                            .GetRequiredService<IHubContext<MyOtherHub>>();
    await CommonHubContextMethod((IHubContext)myHubContext);
    await CommonHubContextMethod((IHubContext)myOtherHubContext);

    await next.Invoke();
}

async Task CommonHubContextMethod(IHubContext context)
{
    await context.Clients.All.SendAsync("clientMethod", new Args());
}

その他のリソース

• 共有フレームワーク内の SignalR アセンブリ
• ASP.NET Core SignalR の概要
• ASP.NET Core でハブを使用するSignalR
• Azure App Service に ASP.NET Core SignalR アプリを発行する