ASP.NET Core SignalR-configuratie

Serialisatieopties voor JSON/MessagePack

ASP.NET Core SignalR ondersteunt twee protocollen voor het coderen van berichten: JSON en MessagePack. Elk protocol heeft serialisatieconfiguratieopties.

JSON-serialisatie kan worden geconfigureerd op de server met behulp van de AddJsonProtocol extensiemethode. AddJsonProtocol kan worden toegevoegd na AddSignalR in Startup.ConfigureServices. De AddJsonProtocol methode gebruikt een gemachtigde die een options object ontvangt. De PayloadSerializerOptions eigenschap op dat object is een System.Text.JsonJsonSerializerOptions object dat kan worden gebruikt voor het configureren van serialisatie van argumenten en retourwaarden. Zie de documentatie system.Text.Json voor meer informatie.

Als u bijvoorbeeld de serializer wilt configureren om het hoofdlettergebruik van eigenschapsnamen niet te wijzigen, in plaats van de standaard camelCase kunt u de volgende code in Program.cs gebruiken:

builder.Services.AddSignalR()
    .AddJsonProtocol(options => {
        options.PayloadSerializerOptions.PropertyNamingPolicy = null;
    });

In de .NET-client bestaat dezelfde AddJsonProtocol extensiemethode op HubConnectionBuilder. De Microsoft.Extensions.DependencyInjection naamruimte moet worden geïmporteerd om de extensiemethode op te lossen:

// At the top of the file:
using Microsoft.Extensions.DependencyInjection;

// When constructing your connection:
var connection = new HubConnectionBuilder()
    .AddJsonProtocol(options => {
        options.PayloadSerializerOptions.PropertyNamingPolicy = null;
    })
    .Build();

Overschakelen naar Newtonsoft.Json

Zie Newtonsoft.Json als u functies van System.Text.Json nodig hebt die niet worden ondersteund in Newtonsoft.Json.

Serialisatieopties voor MessagePack

MessagePack-serialisatie kan worden geconfigureerd door een delegate te verstrekken aan de AddMessagePackProtocol oproep. Zie MessagePack in SignalR voor meer informatie.

Serveropties configureren

In de volgende tabel worden opties beschreven voor het configureren van SignalR hubs:

Opties kunnen worden geconfigureerd voor alle hubs door een opties delegate mee te geven aan de AddSignalR-aanroep in Program.cs.

 builder.Services.AddSignalR(hubOptions =>
 {
     hubOptions.EnableDetailedErrors = true;
     hubOptions.KeepAliveInterval = TimeSpan.FromMinutes(1);
 });

Opties voor een enkele hub overschrijven de algemene opties die zijn opgegeven in AddSignalR en kunnen worden ingesteld met behulp van AddHubOptions:

builder.Services.AddSignalR().AddHubOptions<ChatHub>(options =>
{
    options.EnableDetailedErrors = true;
});

Geavanceerde HTTP-configuratieopties

Hiermee HttpConnectionDispatcherOptions configureert u geavanceerde instellingen met betrekking tot transporten en geheugenbufferbeheer. Deze opties worden geconfigureerd door een gemachtigde door te geven aan MapHub in Program.cs.

using Microsoft.AspNetCore.Http.Connections;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddSignalR();

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();
app.MapHub<ChatHub>("/chathub", options =>
{
    options.Transports =
        HttpTransportType.WebSockets |
        HttpTransportType.LongPolling;
}
);
app.Run();

In de volgende tabel worden opties beschreven voor het configureren van de geavanceerde HTTP-opties van ASP.NET Core SignalR:

Het long polling-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de LongPolling eigenschap:

Het WebSocket-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de WebSockets eigenschap:

Clientopties configureren

Clientopties kunnen worden geconfigureerd voor het HubConnectionBuilder type (beschikbaar in de .NET- en JavaScript-clients). Het is ook beschikbaar in de Java-client, maar de HttpHubConnectionBuilder subklasse bevat de opbouwconfiguratieopties, evenals op de HubConnection zelf.

Logboekregistratie configureren

Logboekregistratie wordt geconfigureerd in de .NET-client met behulp van de ConfigureLogging methode. Providers en filters voor logboekregistratie kunnen op dezelfde manier worden geregistreerd als op de server. Zie de Logging in ASP.NET Core-documentatie voor meer informatie.

Als u bijvoorbeeld consolelogboekregistratie wilt inschakelen, installeert u het Microsoft.Extensions.Logging.Console NuGet-pakket. Roep de AddConsole extensiemethode aan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub")
    .ConfigureLogging(logging => {
        logging.SetMinimumLevel(LogLevel.Information);
        logging.AddConsole();
    })
    .Build();

In de JavaScript-client bestaat een vergelijkbare configureLogging methode. Geef een LogLevel waarde op die het minimale niveau van logboekberichten aangeeft dat moet worden geproduceerd. Logs worden naar het consolevenster van de browser geschreven.

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .configureLogging(signalR.LogLevel.Information)
    .build();

In plaats van een LogLevel waarde kunt u ook een waarde opgeven die een string naam op logboekniveau vertegenwoordigt. Dit is handig bij het configureren van SignalR logboekregistratie in omgevingen waar u geen toegang hebt tot de LogLevel constanten.

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .configureLogging("warn")
    .build();

De volgende tabel bevat de beschikbare logboekniveaus. De waarde die u aan configureLogging opgeeft, stelt het minimale logboekniveau in dat wordt vastgelegd. Berichten die op dit niveau zijn geregistreerd , of de niveaus die erna in de tabel worden vermeld, worden geregistreerd.

Zie de SignalR documentatie over diagnostische gegevens voor meer informatie over logboekregistratie.

De SignalR Java-client maakt gebruik van de SLF4J-bibliotheek voor logboekregistratie. Het is een API voor logboekregistratie op hoog niveau waarmee gebruikers van de bibliotheek hun eigen specifieke implementatie voor logboekregistratie kunnen kiezen door een specifieke afhankelijkheid voor logboekregistratie in te voeren. In het volgende codefragment ziet u hoe u dit kunt gebruiken java.util.logging met de SignalR Java-client.

implementation 'org.slf4j:slf4j-jdk14:1.7.25'

Als u het loggen in uw afhankelijkheden niet configureert, laadt SLF4J een standaard geen-operatie logger met het volgende waarschuwingsbericht:

SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

Dit kan veilig worden genegeerd.

Toegestane transporten configureren

De transporten die door SignalR worden gebruikt, kunnen worden geconfigureerd in de functieaanroep WithUrl (withUrl in JavaScript). Een bitwise-OR van de waarden van HttpTransportType kan worden gebruikt om de client te beperken tot alleen de opgegeven transporten. Alle transporten zijn standaard ingeschakeld.

Als u bijvoorbeeld het transport van Server-Sent gebeurtenissen wilt onderbreken, maar WebSockets- en Long Polling-verbindingen wilt toestaan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", HttpTransportType.WebSockets | HttpTransportType.LongPolling)
    .Build();

In de JavaScript-client worden transporten geconfigureerd door het transport veld in te stellen op het optiesobject dat is opgegeven op withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", { transport: signalR.HttpTransportType.WebSockets | signalR.HttpTransportType.LongPolling })
    .build();

In deze versie van de Java-client WebSockets is het enige beschikbare transport.

In de Java-client wordt het transport geselecteerd met de withTransport methode op de HttpHubConnectionBuilder. De Java-client maakt standaard gebruik van het WebSockets-transport.

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
    .withTransport(TransportEnum.WEBSOCKETS)
    .build();

Bearer-verificatie configureren

Als u verificatiegegevens samen met SignalR aanvragen wilt opgeven, gebruikt u de AccessTokenProvider optie (accessTokenFactory in JavaScript) om een functie op te geven die het gewenste toegangstoken retourneert. In de .NET-client wordt dit toegangstoken doorgegeven als een HTTP-"Bearer Authenticatie"-token (met behulp van de Authorization header met een type Bearer). In de JavaScript-client wordt het toegangstoken gebruikt als een Bearer-token, behalve in enkele gevallen waarin browser-API's de mogelijkheid beperken om headers toe te passen (met name in Server-Sent Gebeurtenissen en WebSockets-aanvragen). In deze gevallen wordt het toegangstoken geleverd als een querytekenreekswaarde access_token.

In de .NET-client kan de AccessTokenProvider optie worden opgegeven met behulp van de gedelegeerde opties in WithUrl:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.AccessTokenProvider = async () => {
            // Get and return the access token.
        };
    })
    .Build();

In de JavaScript-client wordt het toegangstoken geconfigureerd door het accessTokenFactory veld in te stellen op het object Opties in withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        accessTokenFactory: () => {
            // Get and return the access token.
            // This function can return a JavaScript Promise if asynchronous
            // logic is required to retrieve the access token.
        }
    })
    .build();

In de SignalR Java-client kunt u een bearer-token configureren voor verificatie door een toegangstokenfactory op te geven voor httpHubConnectionBuilder. Gebruik withAccessTokenFactory om een RxJavaSingle<String> op te geven. Met een aanroep naar Single.defer kunt u logica schrijven om toegangstokens voor uw client te produceren.

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
    .withAccessTokenProvider(Single.defer(() -> {
        // Your logic here.
        return Single.just("An Access Token");
    })).build();

Time-out en keep-alive-opties configureren

Aanvullende opties voor het configureren van time-out en keep-alive-gedrag:

var builder = new HubConnectionBuilder()
    .WithUrl(Navigation.ToAbsoluteUri("/chathub"))
    .WithServerTimeout(TimeSpan.FromSeconds(60))
    .WithKeepAliveInterval(TimeSpan.FromSeconds(30))
    .Build();

builder.On<string, string>("ReceiveMessage", (user, message) => ...

await builder.StartAsync();

var connection = new signalR.HubConnectionBuilder()
  .withUrl("/chatHub")
  .withServerTimeout(60000)
  .withKeepAliveInterval(30000)
  .build();

Stel stateful opnieuw verbinden in

SignalR stateful opnieuw verbinding maken vermindert de waargenomen downtime van clients die een tijdelijke onderbreking in hun netwerkverbinding hebben, bijvoorbeeld bij het wisselen van netwerkverbindingen of tijdelijk verlies van toegang.

Stateful opnieuw verbinden bereikt dit door het volgende te doen:

• Gegevens tijdelijk bufferen op de server en client.
• Bevestiging van ontvangen berichten (ACK-ing) door zowel de server als de client.
• Herkennen wanneer een verbinding bezig is en berichten die mogelijk zijn verzonden terwijl de verbinding offline was, opnieuw afspelen.

Stateful opnieuw verbinding maken is beschikbaar in .NET 8 of hoger.

Meld u aan om stateful opnieuw verbinding te maken op zowel het eindpunt van de serverhub als de client:

• Werk de configuratie van het serverhub-eindpunt bij om de optie AllowStatefulReconnects in te schakelen:

  app.MapHub<MyHub>("/hubName", options =>
  {
      options.AllowStatefulReconnects = true;
  });
  

  Optioneel kan de maximale buffergrootte in bytes die door de server zijn toegestaan, globaal worden ingesteld of voor een specifieke hub met de optie StatefulReconnectBufferSize:

  De StatefulReconnectBufferSize-optie is wereldwijd ingesteld.

  builder.AddSignalR(o => o.StatefulReconnectBufferSize = 1000);
  

  De StatefulReconnectBufferSize-optie die is ingesteld voor een specifieke hub:

  builder.AddSignalR().AddHubOptions<MyHub>(o => o.StatefulReconnectBufferSize = 1000);
  

  De optie StatefulReconnectBufferSize is optioneel met een standaardwaarde van 100.000 bytes.

• Werk JavaScript- of TypeScript-clientcode bij om de optie withStatefulReconnect in te schakelen:

  const builder = new signalR.HubConnectionBuilder()
    .withUrl("/hubname")
    .withStatefulReconnect({ bufferSize: 1000 });  // Optional, defaults to 100,000
  const connection = builder.build();
  

  De optie bufferSize is optioneel met een standaardwaarde van 100.000 bytes.

• Werk .NET-clientcode bij om de optie WithStatefulReconnect in te schakelen:

    var builder = new HubConnectionBuilder()
        .WithUrl("<hub url>")
        .WithStatefulReconnect();
    builder.Services.Configure<HubConnectionOptions>(o => o.StatefulReconnectBufferSize = 1000);
    var hubConnection = builder.Build();
  

  De optie StatefulReconnectBufferSize is optioneel met een standaardwaarde van 100.000 bytes.

Aanvullende opties configureren

Aanvullende opties kunnen worden geconfigureerd in de WithUrl methode (withUrl in JavaScript) op HubConnectionBuilder of in de verschillende configuratie-API's op de HttpHubConnectionBuilder Java-client:

In de .NET-client kunnen deze opties worden gewijzigd door de optiedelegaat die is opgegeven voor WithUrl.

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.Headers["Foo"] = "Bar";
        options.SkipNegotiation = true;
        options.Transports = HttpTransportType.WebSockets;
        options.Cookies.Add(new Cookie(/* ... */);
        options.ClientCertificates.Add(/* ... */);
    })
    .Build();

In de JavaScript-client kunnen deze opties worden opgegeven in een JavaScript-object dat wordt geleverd aan withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        // "Foo: Bar" will not be sent with WebSockets or Server-Sent Events requests
        headers: { "Foo": "Bar" },
        transport: signalR.HttpTransportType.LongPolling 
    })
    .build();

In de Java-client kunnen deze opties worden geconfigureerd met de methoden op het door de HttpHubConnectionBuilder geretourneerde HubConnectionBuilder.create("HUB URL").

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
        .withHeader("Foo", "Bar")
        .shouldSkipNegotiate(true)
        .withHandshakeResponseTimeout(30*1000)
        .build();

Aanvullende bronnen

• Aan de slag met ASP.NET Core-SignalR
• Hubs gebruiken in ASP.NET Core SignalR
• ASP.NET Core SignalR JavaScript-client
• ASP.NET Core SignalR .NET-client
• MessagePack Hub Protocol gebruiken voor SignalR ASP.NET Core
• ASP.NET Core SignalR ondersteunde platforms

Serialisatieopties voor JSON/MessagePack

ASP.NET Core SignalR ondersteunt twee protocollen voor het coderen van berichten: JSON en MessagePack. Elk protocol heeft serialisatieconfiguratieopties.

JSON-serialisatie kan op de server worden geconfigureerd met behulp van de AddJsonProtocol-extensiemethode, die na AddSignalR kan worden toegevoegd in uw Startup.ConfigureServices-methode. De AddJsonProtocol methode gebruikt een gemachtigde die een options object ontvangt. De PayloadSerializerSettings eigenschap op dat object is een Json.NET-object JsonSerializerSettings dat kan worden gebruikt voor het configureren van serialisatie van argumenten en retourwaarden. Zie de documentatie Json.NET voor meer informatie.

Als u bijvoorbeeld de serializer wilt configureren voor het gebruik van PascalCase-eigenschapsnamen in plaats van de standaard camelCase-namen, gebruikt u de volgende code in :

services.AddSignalR()
    .AddJsonProtocol(options => {
        options.PayloadSerializerSettings.ContractResolver =
            new DefaultContractResolver();
    });

In de .NET-client bestaat dezelfde AddJsonProtocol extensiemethode op HubConnectionBuilder. De Microsoft.Extensions.DependencyInjection naamruimte moet worden geïmporteerd om de extensiemethode op te lossen:

// At the top of the file:
using Microsoft.Extensions.DependencyInjection;

// When constructing your connection:
var connection = new HubConnectionBuilder()
    .AddJsonProtocol(options => {
        options.PayloadSerializerSettings.ContractResolver =
            new DefaultContractResolver();
    })
    .Build();

Serialisatieopties voor MessagePack

MessagePack-serialisatie kan worden geconfigureerd door een delegate te verstrekken aan de AddMessagePackProtocol oproep. Zie MessagePack in SignalR voor meer informatie.

Serveropties configureren

In de volgende tabel worden opties beschreven voor het configureren van SignalR hubs:

Opties kunnen worden geconfigureerd voor alle hubs door een opties delegate mee te geven aan de AddSignalR-aanroep in Startup.ConfigureServices.

public void ConfigureServices(IServiceCollection services)
{
    services.AddSignalR(hubOptions =>
    {
        hubOptions.EnableDetailedErrors = true;
        hubOptions.KeepAliveInterval = TimeSpan.FromMinutes(1);
    });
}

Opties voor een enkele hub overschrijven de algemene opties die zijn opgegeven in AddSignalR en kunnen worden ingesteld met behulp van AddHubOptions:

services.AddSignalR().AddHubOptions<ChatHub>(options =>
{
    options.EnableDetailedErrors = true;
});

Geavanceerde HTTP-configuratieopties

Hiermee HttpConnectionDispatcherOptions configureert u geavanceerde instellingen met betrekking tot transporten en geheugenbufferbeheer. Deze opties worden geconfigureerd door een gemachtigde door te geven aan MapHub in Startup.Configure.

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    app.UseSignalR((configure) =>
    {
        var desiredTransports =
            HttpTransportType.WebSockets |
            HttpTransportType.LongPolling;

        configure.MapHub<ChatHub>("/chathub", (options) =>
        {
            options.Transports = desiredTransports;
        });
    });
}

In de volgende tabel worden opties beschreven voor het configureren van de geavanceerde HTTP-opties van ASP.NET Core SignalR:

Het long polling-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de LongPolling eigenschap:

Het WebSocket-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de WebSockets eigenschap:

Clientopties configureren

Clientopties kunnen worden geconfigureerd voor het HubConnectionBuilder type (beschikbaar in de .NET- en JavaScript-clients). Het is ook beschikbaar in de Java-client, maar de HttpHubConnectionBuilder subklasse bevat de opbouwconfiguratieopties, evenals op de HubConnection zelf.

Logboekregistratie configureren

Logboekregistratie wordt geconfigureerd in de .NET-client met behulp van de ConfigureLogging methode. Providers en filters voor logboekregistratie kunnen op dezelfde manier worden geregistreerd als op de server. Zie de Logging in ASP.NET Core-documentatie voor meer informatie.

Als u bijvoorbeeld consolelogboekregistratie wilt inschakelen, installeert u het Microsoft.Extensions.Logging.Console NuGet-pakket. Roep de AddConsole extensiemethode aan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub")
    .ConfigureLogging(logging => {
        logging.SetMinimumLevel(LogLevel.Information);
        logging.AddConsole();
    })
    .Build();

In de JavaScript-client bestaat een vergelijkbare configureLogging methode. Geef een LogLevel waarde op die het minimale niveau van logboekberichten aangeeft dat moet worden geproduceerd. Logs worden naar het consolevenster van de browser geschreven.

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .configureLogging(signalR.LogLevel.Information)
    .build();

Zie de SignalR documentatie over diagnostische gegevens voor meer informatie over logboekregistratie.

De SignalR Java-client maakt gebruik van de SLF4J-bibliotheek voor logboekregistratie. Het is een API voor logboekregistratie op hoog niveau waarmee gebruikers van de bibliotheek hun eigen specifieke implementatie voor logboekregistratie kunnen kiezen door een specifieke afhankelijkheid voor logboekregistratie in te voeren. In het volgende codefragment ziet u hoe u dit kunt gebruiken java.util.logging met de SignalR Java-client.

implementation 'org.slf4j:slf4j-jdk14:1.7.25'

Als u het loggen in uw afhankelijkheden niet configureert, laadt SLF4J een standaard geen-operatie logger met het volgende waarschuwingsbericht:

SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

Dit kan veilig worden genegeerd.

Toegestane transporten configureren

De transporten die door SignalR worden gebruikt, kunnen worden geconfigureerd in de functieaanroep WithUrl (withUrl in JavaScript). Een bitwise-OR van de waarden van HttpTransportType kan worden gebruikt om de client te beperken tot alleen de opgegeven transporten. Alle transporten zijn standaard ingeschakeld.

Als u bijvoorbeeld het transport van Server-Sent gebeurtenissen wilt onderbreken, maar WebSockets- en Long Polling-verbindingen wilt toestaan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", HttpTransportType.WebSockets | HttpTransportType.LongPolling)
    .Build();

In de JavaScript-client worden transporten geconfigureerd door het transport veld in te stellen op het optiesobject dat is opgegeven op withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", { transport: signalR.HttpTransportType.WebSockets | signalR.HttpTransportType.LongPolling })
    .build();

Bearer-verificatie configureren

Als u verificatiegegevens samen met SignalR aanvragen wilt opgeven, gebruikt u de AccessTokenProvider optie (accessTokenFactory in JavaScript) om een functie op te geven die het gewenste toegangstoken retourneert. In de .NET-client wordt dit toegangstoken doorgegeven als een HTTP-"Bearer Authenticatie"-token (met behulp van de Authorization header met een type Bearer). In de JavaScript-client wordt het toegangstoken gebruikt als een Bearer-token, behalve in enkele gevallen waarin browser-API's de mogelijkheid beperken om headers toe te passen (met name in Server-Sent Gebeurtenissen en WebSockets-aanvragen). In deze gevallen wordt het toegangstoken geleverd als een querytekenreekswaarde access_token.

In de .NET-client kan de AccessTokenProvider optie worden opgegeven met behulp van de gedelegeerde opties in WithUrl:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.AccessTokenProvider = async () => {
            // Get and return the access token.
        };
    })
    .Build();

In de JavaScript-client wordt het toegangstoken geconfigureerd door het accessTokenFactory veld in te stellen op het object Opties in withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        accessTokenFactory: () => {
            // Get and return the access token.
            // This function can return a JavaScript Promise if asynchronous
            // logic is required to retrieve the access token.
        }
    })
    .build();

In de SignalR Java-client kunt u een bearer-token configureren voor verificatie door een toegangstokenfactory op te geven voor httpHubConnectionBuilder. Gebruik withAccessTokenFactory om een RxJavaSingle<String> op te geven. Met een aanroep naar Single.defer kunt u logica schrijven om toegangstokens voor uw client te produceren.

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
    .withAccessTokenProvider(Single.defer(() -> {
        // Your logic here.
        return Single.just("An Access Token");
    })).build();

Time-out en keep-alive-opties configureren

Aanvullende opties voor het configureren van time-out en keep-alive-gedrag zijn beschikbaar op het HubConnection object zelf:

Aanvullende opties configureren

Aanvullende opties kunnen worden geconfigureerd in de WithUrl methode (withUrl in JavaScript) op HubConnectionBuilder of in de verschillende configuratie-API's op de HttpHubConnectionBuilder Java-client:

In de .NET-client kunnen deze opties worden gewijzigd door de optiedelegaat die is opgegeven voor WithUrl.

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.Headers["Foo"] = "Bar";
        options.Cookies.Add(new Cookie(/* ... */);
        options.ClientCertificates.Add(/* ... */);
    })
    .Build();

In de JavaScript-client kunnen deze opties worden opgegeven in een JavaScript-object dat wordt geleverd aan withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        skipNegotiation: true,
        transport: signalR.HttpTransportType.WebSockets
    })
    .build();

In de Java-client kunnen deze opties worden geconfigureerd met de methoden op het door de HttpHubConnectionBuilder geretourneerde HubConnectionBuilder.create("HUB URL").

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
        .withHeader("Foo", "Bar")
        .shouldSkipNegotiate(true)
        .withHandshakeResponseTimeout(30*1000)
        .build();

Aanvullende bronnen

• Aan de slag met ASP.NET Core-SignalR
• Hubs gebruiken in ASP.NET Core SignalR
• ASP.NET Core SignalR JavaScript-client
• ASP.NET Core SignalR .NET-client
• MessagePack Hub Protocol gebruiken voor SignalR ASP.NET Core
• ASP.NET Core SignalR ondersteunde platforms

Serialisatieopties voor JSON/MessagePack

ASP.NET Core SignalR ondersteunt twee protocollen voor het coderen van berichten: JSON en MessagePack. Elk protocol heeft serialisatieconfiguratieopties.

JSON-serialisatie kan op de server worden geconfigureerd met behulp van de AddJsonProtocol-extensiemethode, die na AddSignalR kan worden toegevoegd in uw Startup.ConfigureServices-methode. De AddJsonProtocol methode gebruikt een gemachtigde die een options object ontvangt. De PayloadSerializerSettings eigenschap op dat object is een Json.NET-object JsonSerializerSettings dat kan worden gebruikt voor het configureren van serialisatie van argumenten en retourwaarden. Zie de documentatie Json.NET voor meer informatie.

Als u bijvoorbeeld de serializer wilt configureren voor het gebruik van PascalCase-eigenschapsnamen in plaats van de standaard camelCase-namen, gebruikt u de volgende code in :

services.AddSignalR()
    .AddJsonProtocol(options => {
        options.PayloadSerializerSettings.ContractResolver =
            new DefaultContractResolver();
    });

In de .NET-client bestaat dezelfde AddJsonProtocol extensiemethode op HubConnectionBuilder. De Microsoft.Extensions.DependencyInjection naamruimte moet worden geïmporteerd om de extensiemethode op te lossen:

// At the top of the file:
using Microsoft.Extensions.DependencyInjection;

// When constructing your connection:
var connection = new HubConnectionBuilder()
    .AddJsonProtocol(options => {
        options.PayloadSerializerSettings.ContractResolver =
            new DefaultContractResolver();
    })
    .Build();

Serialisatieopties voor MessagePack

MessagePack-serialisatie kan worden geconfigureerd door een delegate te verstrekken aan de AddMessagePackProtocol oproep. Zie MessagePack in SignalR voor meer informatie.

Serveropties configureren

In de volgende tabel worden opties beschreven voor het configureren van SignalR hubs:

Opties kunnen worden geconfigureerd voor alle hubs door een opties delegate mee te geven aan de AddSignalR-aanroep in Startup.ConfigureServices.

public void ConfigureServices(IServiceCollection services)
{
    services.AddSignalR(hubOptions =>
    {
        hubOptions.EnableDetailedErrors = true;
        hubOptions.KeepAliveInterval = TimeSpan.FromMinutes(1);
    });
}

Opties voor een enkele hub overschrijven de algemene opties die zijn opgegeven in AddSignalR en kunnen worden ingesteld met behulp van AddHubOptions:

services.AddSignalR().AddHubOptions<ChatHub>(options =>
{
    options.EnableDetailedErrors = true;
});

Geavanceerde HTTP-configuratieopties

Hiermee HttpConnectionDispatcherOptions configureert u geavanceerde instellingen met betrekking tot transporten en geheugenbufferbeheer. Deze opties worden geconfigureerd door een gemachtigde door te geven aan MapHub in Startup.Configure.

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    app.UseSignalR((configure) =>
    {
        var desiredTransports =
            HttpTransportType.WebSockets |
            HttpTransportType.LongPolling;

        configure.MapHub<ChatHub>("/chathub", (options) =>
        {
            options.Transports = desiredTransports;
        });
    });
}

In de volgende tabel worden opties beschreven voor het configureren van de geavanceerde HTTP-opties van ASP.NET Core SignalR:

Het long polling-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de LongPolling eigenschap:

Het WebSocket-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de WebSockets eigenschap:

Clientopties configureren

Clientopties kunnen worden geconfigureerd voor het HubConnectionBuilder type (beschikbaar in de .NET- en JavaScript-clients). Het is ook beschikbaar in de Java-client, maar de HttpHubConnectionBuilder subklasse bevat de opbouwconfiguratieopties, evenals op de HubConnection zelf.

Logboekregistratie configureren

Logboekregistratie wordt geconfigureerd in de .NET-client met behulp van de ConfigureLogging methode. Providers en filters voor logboekregistratie kunnen op dezelfde manier worden geregistreerd als op de server. Zie de Logging in ASP.NET Core-documentatie voor meer informatie.

Als u bijvoorbeeld consolelogboekregistratie wilt inschakelen, installeert u het Microsoft.Extensions.Logging.Console NuGet-pakket. Roep de AddConsole extensiemethode aan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub")
    .ConfigureLogging(logging => {
        logging.SetMinimumLevel(LogLevel.Information);
        logging.AddConsole();
    })
    .Build();

In de JavaScript-client bestaat een vergelijkbare configureLogging methode. Geef een LogLevel waarde op die het minimale niveau van logboekberichten aangeeft dat moet worden geproduceerd. Logs worden naar het consolevenster van de browser geschreven.

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .configureLogging(signalR.LogLevel.Information)
    .build();

Zie de SignalR documentatie over diagnostische gegevens voor meer informatie over logboekregistratie.

De SignalR Java-client maakt gebruik van de SLF4J-bibliotheek voor logboekregistratie. Het is een API voor logboekregistratie op hoog niveau waarmee gebruikers van de bibliotheek hun eigen specifieke implementatie voor logboekregistratie kunnen kiezen door een specifieke afhankelijkheid voor logboekregistratie in te voeren. In het volgende codefragment ziet u hoe u dit kunt gebruiken java.util.logging met de SignalR Java-client.

implementation 'org.slf4j:slf4j-jdk14:1.7.25'

Als u het loggen in uw afhankelijkheden niet configureert, laadt SLF4J een standaard geen-operatie logger met het volgende waarschuwingsbericht:

SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

Dit kan veilig worden genegeerd.

Toegestane transporten configureren

De transporten die door SignalR worden gebruikt, kunnen worden geconfigureerd in de functieaanroep WithUrl (withUrl in JavaScript). Een bitwise-OR van de waarden van HttpTransportType kan worden gebruikt om de client te beperken tot alleen de opgegeven transporten. Alle transporten zijn standaard ingeschakeld.

Als u bijvoorbeeld het transport van Server-Sent gebeurtenissen wilt onderbreken, maar WebSockets- en Long Polling-verbindingen wilt toestaan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", HttpTransportType.WebSockets | HttpTransportType.LongPolling)
    .Build();

In de JavaScript-client worden transporten geconfigureerd door het transport veld in te stellen op het optiesobject dat is opgegeven op withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", { transport: signalR.HttpTransportType.WebSockets | signalR.HttpTransportType.LongPolling })
    .build();

In deze versie van de Java-client WebSockets is het enige beschikbare transport.

Bearer-verificatie configureren

Als u verificatiegegevens samen met SignalR aanvragen wilt opgeven, gebruikt u de AccessTokenProvider optie (accessTokenFactory in JavaScript) om een functie op te geven die het gewenste toegangstoken retourneert. In de .NET-client wordt dit toegangstoken doorgegeven als een HTTP-"Bearer Authenticatie"-token (met behulp van de Authorization header met een type Bearer). In de JavaScript-client wordt het toegangstoken gebruikt als een Bearer-token, behalve in enkele gevallen waarin browser-API's de mogelijkheid beperken om headers toe te passen (met name in Server-Sent Gebeurtenissen en WebSockets-aanvragen). In deze gevallen wordt het toegangstoken geleverd als een querytekenreekswaarde access_token.

In de .NET-client kan de AccessTokenProvider optie worden opgegeven met behulp van de gedelegeerde opties in WithUrl:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.AccessTokenProvider = async () => {
            // Get and return the access token.
        };
    })
    .Build();

In de JavaScript-client wordt het toegangstoken geconfigureerd door het accessTokenFactory veld in te stellen op het object Opties in withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        accessTokenFactory: () => {
            // Get and return the access token.
            // This function can return a JavaScript Promise if asynchronous
            // logic is required to retrieve the access token.
        }
    })
    .build();

In de SignalR Java-client kunt u een bearer-token configureren voor verificatie door een toegangstokenfactory op te geven voor httpHubConnectionBuilder. Gebruik withAccessTokenFactory om een RxJavaSingle<String> op te geven. Met een aanroep naar Single.defer kunt u logica schrijven om toegangstokens voor uw client te produceren.

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
    .withAccessTokenProvider(Single.defer(() -> {
        // Your logic here.
        return Single.just("An Access Token");
    })).build();

Time-out en keep-alive-opties configureren

Aanvullende opties voor het configureren van time-out en keep-alive-gedrag zijn beschikbaar op het HubConnection object zelf:

Aanvullende opties configureren

Aanvullende opties kunnen worden geconfigureerd in de WithUrl methode (withUrl in JavaScript) op HubConnectionBuilder of in de verschillende configuratie-API's op de HttpHubConnectionBuilder Java-client:

In de .NET-client kunnen deze opties worden gewijzigd door de optiedelegaat die is opgegeven voor WithUrl.

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.Headers["Foo"] = "Bar";
        options.Cookies.Add(new Cookie(/* ... */);
        options.ClientCertificates.Add(/* ... */);
    })
    .Build();

In de JavaScript-client kunnen deze opties worden opgegeven in een JavaScript-object dat wordt geleverd aan withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        skipNegotiation: true,
        transport: signalR.HttpTransportType.WebSockets
    })
    .build();

In de Java-client kunnen deze opties worden geconfigureerd met de methoden op het door de HttpHubConnectionBuilder geretourneerde HubConnectionBuilder.create("HUB URL").

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
        .withHeader("Foo", "Bar")
        .shouldSkipNegotiate(true)
        .withHandshakeResponseTimeout(30*1000)
        .build();

Aanvullende bronnen

• Aan de slag met ASP.NET Core-SignalR
• Hubs gebruiken in ASP.NET Core SignalR
• ASP.NET Core SignalR JavaScript-client
• ASP.NET Core SignalR .NET-client
• MessagePack Hub Protocol gebruiken voor SignalR ASP.NET Core
• ASP.NET Core SignalR ondersteunde platforms

Serialisatieopties voor JSON/MessagePack

ASP.NET Core SignalR ondersteunt twee protocollen voor het coderen van berichten: JSON en MessagePack. Elk protocol heeft serialisatieconfiguratieopties.

JSON-serialisatie kan worden geconfigureerd op de server met behulp van de AddJsonProtocol extensiemethode. AddJsonProtocol kan worden toegevoegd na AddSignalR in Startup.ConfigureServices. De AddJsonProtocol methode gebruikt een gemachtigde die een options object ontvangt. De PayloadSerializerOptions eigenschap op dat object is een System.Text.JsonJsonSerializerOptions object dat kan worden gebruikt voor het configureren van serialisatie van argumenten en retourwaarden. Zie de documentatie system.Text.Json voor meer informatie.

Als u bijvoorbeeld de serializer wilt configureren om het hoofdlettergebruik van eigenschapsnamen niet te wijzigen, in plaats van de standaard camelCase kunt u de volgende code in Startup.ConfigureServices gebruiken:

services.AddSignalR()
    .AddJsonProtocol(options => {
        options.PayloadSerializerOptions.PropertyNamingPolicy = null;
    });

In de .NET-client bestaat dezelfde AddJsonProtocol extensiemethode op HubConnectionBuilder. De Microsoft.Extensions.DependencyInjection naamruimte moet worden geïmporteerd om de extensiemethode op te lossen:

// At the top of the file:
using Microsoft.Extensions.DependencyInjection;

// When constructing your connection:
var connection = new HubConnectionBuilder()
    .AddJsonProtocol(options => {
        options.PayloadSerializerOptions.PropertyNamingPolicy = null;
    })
    .Build();

Overschakelen naar Newtonsoft.Json

Zie Newtonsoft.Json als u functies van System.Text.Json nodig hebt die niet worden ondersteund in Newtonsoft.Json.

Serialisatieopties voor MessagePack

MessagePack-serialisatie kan worden geconfigureerd door een delegate te verstrekken aan de AddMessagePackProtocol oproep. Zie MessagePack in SignalR voor meer informatie.

Serveropties configureren

In de volgende tabel worden opties beschreven voor het configureren van SignalR hubs:

Opties kunnen worden geconfigureerd voor alle hubs door een opties delegate mee te geven aan de AddSignalR-aanroep in Startup.ConfigureServices.

public void ConfigureServices(IServiceCollection services)
{
    services.AddSignalR(hubOptions =>
    {
        hubOptions.EnableDetailedErrors = true;
        hubOptions.KeepAliveInterval = TimeSpan.FromMinutes(1);
    });
}

Opties voor een enkele hub overschrijven de algemene opties die zijn opgegeven in AddSignalR en kunnen worden ingesteld met behulp van AddHubOptions:

services.AddSignalR().AddHubOptions<ChatHub>(options =>
{
    options.EnableDetailedErrors = true;
});

Geavanceerde HTTP-configuratieopties

Hiermee HttpConnectionDispatcherOptions configureert u geavanceerde instellingen met betrekking tot transporten en geheugenbufferbeheer. Deze opties worden geconfigureerd door een gemachtigde door te geven aan MapHub in Startup.Configure.

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    app.UseRouting();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapHub<ChatHub>("/chathub", options =>
        {
            options.Transports =
                HttpTransportType.WebSockets |
                HttpTransportType.LongPolling;
        });
    });
}

In de volgende tabel worden opties beschreven voor het configureren van de geavanceerde HTTP-opties van ASP.NET Core SignalR:

Het long polling-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de LongPolling eigenschap:

Het WebSocket-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de WebSockets eigenschap:

Clientopties configureren

Clientopties kunnen worden geconfigureerd voor het HubConnectionBuilder type (beschikbaar in de .NET- en JavaScript-clients). Het is ook beschikbaar in de Java-client, maar de HttpHubConnectionBuilder subklasse bevat de opbouwconfiguratieopties, evenals op de HubConnection zelf.

Logboekregistratie configureren

Logboekregistratie wordt geconfigureerd in de .NET-client met behulp van de ConfigureLogging methode. Providers en filters voor logboekregistratie kunnen op dezelfde manier worden geregistreerd als op de server. Zie de Logging in ASP.NET Core-documentatie voor meer informatie.

Als u bijvoorbeeld consolelogboekregistratie wilt inschakelen, installeert u het Microsoft.Extensions.Logging.Console NuGet-pakket. Roep de AddConsole extensiemethode aan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub")
    .ConfigureLogging(logging => {
        logging.SetMinimumLevel(LogLevel.Information);
        logging.AddConsole();
    })
    .Build();

In de JavaScript-client bestaat een vergelijkbare configureLogging methode. Geef een LogLevel waarde op die het minimale niveau van logboekberichten aangeeft dat moet worden geproduceerd. Logs worden naar het consolevenster van de browser geschreven.

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .configureLogging(signalR.LogLevel.Information)
    .build();

In plaats van een LogLevel waarde kunt u ook een waarde opgeven die een string naam op logboekniveau vertegenwoordigt. Dit is handig bij het configureren van SignalR logboekregistratie in omgevingen waar u geen toegang hebt tot de LogLevel constanten.

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .configureLogging("warn")
    .build();

De volgende tabel bevat de beschikbare logboekniveaus. De waarde die u aan configureLogging opgeeft, stelt het minimale logboekniveau in dat wordt vastgelegd. Berichten die op dit niveau zijn geregistreerd , of de niveaus die erna in de tabel worden vermeld, worden geregistreerd.

Zie de SignalR documentatie over diagnostische gegevens voor meer informatie over logboekregistratie.

De SignalR Java-client maakt gebruik van de SLF4J-bibliotheek voor logboekregistratie. Het is een API voor logboekregistratie op hoog niveau waarmee gebruikers van de bibliotheek hun eigen specifieke implementatie voor logboekregistratie kunnen kiezen door een specifieke afhankelijkheid voor logboekregistratie in te voeren. In het volgende codefragment ziet u hoe u dit kunt gebruiken java.util.logging met de SignalR Java-client.

implementation 'org.slf4j:slf4j-jdk14:1.7.25'

Als u het loggen in uw afhankelijkheden niet configureert, laadt SLF4J een standaard geen-operatie logger met het volgende waarschuwingsbericht:

SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

Dit kan veilig worden genegeerd.

Toegestane transporten configureren

De transporten die door SignalR worden gebruikt, kunnen worden geconfigureerd in de functieaanroep WithUrl (withUrl in JavaScript). Een bitwise-OR van de waarden van HttpTransportType kan worden gebruikt om de client te beperken tot alleen de opgegeven transporten. Alle transporten zijn standaard ingeschakeld.

Als u bijvoorbeeld het transport van Server-Sent gebeurtenissen wilt onderbreken, maar WebSockets- en Long Polling-verbindingen wilt toestaan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", HttpTransportType.WebSockets | HttpTransportType.LongPolling)
    .Build();

In de JavaScript-client worden transporten geconfigureerd door het transport veld in te stellen op het optiesobject dat is opgegeven op withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", { transport: signalR.HttpTransportType.WebSockets | signalR.HttpTransportType.LongPolling })
    .build();

In deze versie van de Java-client WebSockets is het enige beschikbare transport.

In de Java-client wordt het transport geselecteerd met de withTransport methode op de HttpHubConnectionBuilder. De Java-client maakt standaard gebruik van het WebSockets-transport.

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
    .withTransport(TransportEnum.WEBSOCKETS)
    .build();

Bearer-verificatie configureren

Als u verificatiegegevens samen met SignalR aanvragen wilt opgeven, gebruikt u de AccessTokenProvider optie (accessTokenFactory in JavaScript) om een functie op te geven die het gewenste toegangstoken retourneert. In de .NET-client wordt dit toegangstoken doorgegeven als een HTTP-"Bearer Authenticatie"-token (met behulp van de Authorization header met een type Bearer). In de JavaScript-client wordt het toegangstoken gebruikt als een Bearer-token, behalve in enkele gevallen waarin browser-API's de mogelijkheid beperken om headers toe te passen (met name in Server-Sent Gebeurtenissen en WebSockets-aanvragen). In deze gevallen wordt het toegangstoken geleverd als een querytekenreekswaarde access_token.

In de .NET-client kan de AccessTokenProvider optie worden opgegeven met behulp van de gedelegeerde opties in WithUrl:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.AccessTokenProvider = async () => {
            // Get and return the access token.
        };
    })
    .Build();

In de JavaScript-client wordt het toegangstoken geconfigureerd door het accessTokenFactory veld in te stellen op het object Opties in withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        accessTokenFactory: () => {
            // Get and return the access token.
            // This function can return a JavaScript Promise if asynchronous
            // logic is required to retrieve the access token.
        }
    })
    .build();

In de SignalR Java-client kunt u een bearer-token configureren voor verificatie door een toegangstokenfactory op te geven voor httpHubConnectionBuilder. Gebruik withAccessTokenFactory om een RxJavaSingle<String> op te geven. Met een aanroep naar Single.defer kunt u logica schrijven om toegangstokens voor uw client te produceren.

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
    .withAccessTokenProvider(Single.defer(() -> {
        // Your logic here.
        return Single.just("An Access Token");
    })).build();

Time-out en keep-alive-opties configureren

Aanvullende opties voor het configureren van time-out en keep-alive-gedrag zijn beschikbaar op het HubConnection object zelf:

Aanvullende opties configureren

Aanvullende opties kunnen worden geconfigureerd in de WithUrl methode (withUrl in JavaScript) op HubConnectionBuilder of in de verschillende configuratie-API's op de HttpHubConnectionBuilder Java-client:

In de .NET-client kunnen deze opties worden gewijzigd door de optiedelegaat die is opgegeven voor WithUrl.

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.Headers["Foo"] = "Bar";
        options.Cookies.Add(new Cookie(/* ... */);
        options.ClientCertificates.Add(/* ... */);
    })
    .Build();

In de JavaScript-client kunnen deze opties worden opgegeven in een JavaScript-object dat wordt geleverd aan withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        skipNegotiation: true,
        transport: signalR.HttpTransportType.WebSockets
    })
    .build();

In de Java-client kunnen deze opties worden geconfigureerd met de methoden op het door de HttpHubConnectionBuilder geretourneerde HubConnectionBuilder.create("HUB URL").

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
        .withHeader("Foo", "Bar")
        .shouldSkipNegotiate(true)
        .withHandshakeResponseTimeout(30*1000)
        .build();

Aanvullende bronnen

• Aan de slag met ASP.NET Core-SignalR
• Hubs gebruiken in ASP.NET Core SignalR
• ASP.NET Core SignalR JavaScript-client
• ASP.NET Core SignalR .NET-client
• MessagePack Hub Protocol gebruiken voor SignalR ASP.NET Core
• ASP.NET Core SignalR ondersteunde platforms

Serialisatieopties voor JSON/MessagePack

ASP.NET Core SignalR ondersteunt twee protocollen voor het coderen van berichten: JSON en MessagePack. Elk protocol heeft serialisatieconfiguratieopties.

JSON-serialisatie kan worden geconfigureerd op de server met behulp van de AddJsonProtocol extensiemethode. AddJsonProtocol kan worden toegevoegd na AddSignalR in Startup.ConfigureServices. De AddJsonProtocol methode gebruikt een gemachtigde die een options object ontvangt. De PayloadSerializerOptions eigenschap op dat object is een System.Text.JsonJsonSerializerOptions object dat kan worden gebruikt voor het configureren van serialisatie van argumenten en retourwaarden. Zie de documentatie system.Text.Json voor meer informatie.

Als u bijvoorbeeld de serializer wilt configureren om het hoofdlettergebruik van eigenschapsnamen niet te wijzigen, in plaats van de standaard camelCase kunt u de volgende code in Startup.ConfigureServices gebruiken:

services.AddSignalR()
    .AddJsonProtocol(options => {
        options.PayloadSerializerOptions.PropertyNamingPolicy = null
    });

In de .NET-client bestaat dezelfde AddJsonProtocol extensiemethode op HubConnectionBuilder. De Microsoft.Extensions.DependencyInjection naamruimte moet worden geïmporteerd om de extensiemethode op te lossen:

// At the top of the file:
using Microsoft.Extensions.DependencyInjection;

// When constructing your connection:
var connection = new HubConnectionBuilder()
    .AddJsonProtocol(options => {
        options.PayloadSerializerOptions.PropertyNamingPolicy = null;
    })
    .Build();

Overschakelen naar Newtonsoft.Json

Zie Newtonsoft.Json als u functies van System.Text.Json nodig hebt die niet worden ondersteund in Newtonsoft.Json.

Serialisatieopties voor MessagePack

MessagePack-serialisatie kan worden geconfigureerd door een delegate te verstrekken aan de AddMessagePackProtocol oproep. Zie MessagePack in SignalR voor meer informatie.

Serveropties configureren

In de volgende tabel worden opties beschreven voor het configureren van SignalR hubs:

Opties kunnen worden geconfigureerd voor alle hubs door een opties delegate mee te geven aan de AddSignalR-aanroep in Startup.ConfigureServices.

public void ConfigureServices(IServiceCollection services)
{
    services.AddSignalR(hubOptions =>
    {
        hubOptions.EnableDetailedErrors = true;
        hubOptions.KeepAliveInterval = TimeSpan.FromMinutes(1);
    });
}

Opties voor een enkele hub overschrijven de algemene opties die zijn opgegeven in AddSignalR en kunnen worden ingesteld met behulp van AddHubOptions:

services.AddSignalR().AddHubOptions<ChatHub>(options =>
{
    options.EnableDetailedErrors = true;
});

Geavanceerde HTTP-configuratieopties

Hiermee HttpConnectionDispatcherOptions configureert u geavanceerde instellingen met betrekking tot transporten en geheugenbufferbeheer. Deze opties worden geconfigureerd door een gemachtigde door te geven aan MapHub in Startup.Configure.

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    app.UseRouting();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapHub<ChatHub>("/chathub", options =>
        {
            options.Transports =
                HttpTransportType.WebSockets |
                HttpTransportType.LongPolling;
        });
    });
}

In de volgende tabel worden opties beschreven voor het configureren van de geavanceerde HTTP-opties van ASP.NET Core SignalR:

Het long polling-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de LongPolling eigenschap:

Het WebSocket-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de WebSockets eigenschap:

Clientopties configureren

Clientopties kunnen worden geconfigureerd voor het HubConnectionBuilder type (beschikbaar in de .NET- en JavaScript-clients). Het is ook beschikbaar in de Java-client, maar de HttpHubConnectionBuilder subklasse bevat de opbouwconfiguratieopties, evenals op de HubConnection zelf.

Logboekregistratie configureren

Logboekregistratie wordt geconfigureerd in de .NET-client met behulp van de ConfigureLogging methode. Providers en filters voor logboekregistratie kunnen op dezelfde manier worden geregistreerd als op de server. Zie de Logging in ASP.NET Core-documentatie voor meer informatie.

Als u bijvoorbeeld consolelogboekregistratie wilt inschakelen, installeert u het Microsoft.Extensions.Logging.Console NuGet-pakket. Roep de AddConsole extensiemethode aan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub")
    .ConfigureLogging(logging => {
        logging.SetMinimumLevel(LogLevel.Information);
        logging.AddConsole();
    })
    .Build();

In de JavaScript-client bestaat een vergelijkbare configureLogging methode. Geef een LogLevel waarde op die het minimale niveau van logboekberichten aangeeft dat moet worden geproduceerd. Logs worden naar het consolevenster van de browser geschreven.

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .configureLogging(signalR.LogLevel.Information)
    .build();

In plaats van een LogLevel waarde kunt u ook een waarde opgeven die een string naam op logboekniveau vertegenwoordigt. Dit is handig bij het configureren van SignalR logboekregistratie in omgevingen waar u geen toegang hebt tot de LogLevel constanten.

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .configureLogging("warn")
    .build();

De volgende tabel bevat de beschikbare logboekniveaus. De waarde die u aan configureLogging opgeeft, stelt het minimale logboekniveau in dat wordt vastgelegd. Berichten die op dit niveau zijn geregistreerd , of de niveaus die erna in de tabel worden vermeld, worden geregistreerd.

Zie de SignalR documentatie over diagnostische gegevens voor meer informatie over logboekregistratie.

De SignalR Java-client maakt gebruik van de SLF4J-bibliotheek voor logboekregistratie. Het is een API voor logboekregistratie op hoog niveau waarmee gebruikers van de bibliotheek hun eigen specifieke implementatie voor logboekregistratie kunnen kiezen door een specifieke afhankelijkheid voor logboekregistratie in te voeren. In het volgende codefragment ziet u hoe u dit kunt gebruiken java.util.logging met de SignalR Java-client.

implementation 'org.slf4j:slf4j-jdk14:1.7.25'

Als u het loggen in uw afhankelijkheden niet configureert, laadt SLF4J een standaard geen-operatie logger met het volgende waarschuwingsbericht:

SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

Dit kan veilig worden genegeerd.

Toegestane transporten configureren

De transporten die door SignalR worden gebruikt, kunnen worden geconfigureerd in de functieaanroep WithUrl (withUrl in JavaScript). Een bitwise-OR van de waarden van HttpTransportType kan worden gebruikt om de client te beperken tot alleen de opgegeven transporten. Alle transporten zijn standaard ingeschakeld.

Als u bijvoorbeeld het transport van Server-Sent gebeurtenissen wilt onderbreken, maar WebSockets- en Long Polling-verbindingen wilt toestaan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", HttpTransportType.WebSockets | HttpTransportType.LongPolling)
    .Build();

In de JavaScript-client worden transporten geconfigureerd door het transport veld in te stellen op het optiesobject dat is opgegeven op withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", { transport: signalR.HttpTransportType.WebSockets | signalR.HttpTransportType.LongPolling })
    .build();

In deze versie van de Java-client WebSockets is het enige beschikbare transport.

In de Java-client wordt het transport geselecteerd met de withTransport methode op de HttpHubConnectionBuilder. De Java-client maakt standaard gebruik van het WebSockets-transport.

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
    .withTransport(TransportEnum.WEBSOCKETS)
    .build();

Bearer-verificatie configureren

Als u verificatiegegevens samen met SignalR aanvragen wilt opgeven, gebruikt u de AccessTokenProvider optie (accessTokenFactory in JavaScript) om een functie op te geven die het gewenste toegangstoken retourneert. In de .NET-client wordt dit toegangstoken doorgegeven als een HTTP-"Bearer Authenticatie"-token (met behulp van de Authorization header met een type Bearer). In de JavaScript-client wordt het toegangstoken gebruikt als een Bearer-token, behalve in enkele gevallen waarin browser-API's de mogelijkheid beperken om headers toe te passen (met name in Server-Sent Gebeurtenissen en WebSockets-aanvragen). In deze gevallen wordt het toegangstoken geleverd als een querytekenreekswaarde access_token.

In de .NET-client kan de AccessTokenProvider optie worden opgegeven met behulp van de gedelegeerde opties in WithUrl:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.AccessTokenProvider = async () => {
            // Get and return the access token.
        };
    })
    .Build();

In de JavaScript-client wordt het toegangstoken geconfigureerd door het accessTokenFactory veld in te stellen op het object Opties in withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        accessTokenFactory: () => {
            // Get and return the access token.
            // This function can return a JavaScript Promise if asynchronous
            // logic is required to retrieve the access token.
        }
    })
    .build();

In de SignalR Java-client kunt u een bearer-token configureren voor verificatie door een toegangstokenfactory op te geven voor httpHubConnectionBuilder. Gebruik withAccessTokenFactory om een RxJavaSingle<String> op te geven. Met een aanroep naar Single.defer kunt u logica schrijven om toegangstokens voor uw client te produceren.

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
    .withAccessTokenProvider(Single.defer(() -> {
        // Your logic here.
        return Single.just("An Access Token");
    })).build();

Time-out en keep-alive-opties configureren

Aanvullende opties voor het configureren van time-out en keep-alive-gedrag zijn beschikbaar op het HubConnection object zelf:

Aanvullende opties configureren

Aanvullende opties kunnen worden geconfigureerd in de WithUrl methode (withUrl in JavaScript) op HubConnectionBuilder of in de verschillende configuratie-API's op de HttpHubConnectionBuilder Java-client:

In de .NET-client kunnen deze opties worden gewijzigd door de optiedelegaat die is opgegeven voor WithUrl.

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.Headers["Foo"] = "Bar";
        options.Cookies.Add(new Cookie(/* ... */);
        options.ClientCertificates.Add(/* ... */);
    })
    .Build();

In de JavaScript-client kunnen deze opties worden opgegeven in een JavaScript-object dat wordt geleverd aan withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        skipNegotiation: true,
        transport: signalR.HttpTransportType.WebSockets
    })
    .build();

In de Java-client kunnen deze opties worden geconfigureerd met de methoden op het door de HttpHubConnectionBuilder geretourneerde HubConnectionBuilder.create("HUB URL").

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
        .withHeader("Foo", "Bar")
        .shouldSkipNegotiate(true)
        .withHandshakeResponseTimeout(30*1000)
        .build();

Aanvullende bronnen

• Aan de slag met ASP.NET Core-SignalR
• Hubs gebruiken in ASP.NET Core SignalR
• ASP.NET Core SignalR JavaScript-client
• ASP.NET Core SignalR .NET-client
• MessagePack Hub Protocol gebruiken voor SignalR ASP.NET Core
• ASP.NET Core SignalR ondersteunde platforms

Serialisatieopties voor JSON/MessagePack

ASP.NET Core SignalR ondersteunt twee protocollen voor het coderen van berichten: JSON en MessagePack. Elk protocol heeft serialisatieconfiguratieopties.

JSON-serialisatie kan worden geconfigureerd op de server met behulp van de AddJsonProtocol extensiemethode. AddJsonProtocol kan worden toegevoegd na AddSignalR in Startup.ConfigureServices. De AddJsonProtocol methode gebruikt een gemachtigde die een options object ontvangt. De PayloadSerializerOptions eigenschap op dat object is een System.Text.JsonJsonSerializerOptions object dat kan worden gebruikt voor het configureren van serialisatie van argumenten en retourwaarden. Zie de documentatie system.Text.Json voor meer informatie.

Als u bijvoorbeeld de serializer wilt configureren om het hoofdlettergebruik van eigenschapsnamen niet te wijzigen, in plaats van de standaard camelCase kunt u de volgende code in Startup.ConfigureServices gebruiken:

services.AddSignalR()
    .AddJsonProtocol(options => {
        options.PayloadSerializerOptions.PropertyNamingPolicy = null;
    });

In de .NET-client bestaat dezelfde AddJsonProtocol extensiemethode op HubConnectionBuilder. De Microsoft.Extensions.DependencyInjection naamruimte moet worden geïmporteerd om de extensiemethode op te lossen:

// At the top of the file:
using Microsoft.Extensions.DependencyInjection;

// When constructing your connection:
var connection = new HubConnectionBuilder()
    .AddJsonProtocol(options => {
        options.PayloadSerializerOptions.PropertyNamingPolicy = null;
    })
    .Build();

Overschakelen naar Newtonsoft.Json

Zie Newtonsoft.Json als u functies van System.Text.Json nodig hebt die niet worden ondersteund in Newtonsoft.Json.

Serialisatieopties voor MessagePack

MessagePack-serialisatie kan worden geconfigureerd door een delegate te verstrekken aan de AddMessagePackProtocol oproep. Zie MessagePack in SignalR voor meer informatie.

Serveropties configureren

In de volgende tabel worden opties beschreven voor het configureren van SignalR hubs:

Opties kunnen worden geconfigureerd voor alle hubs door een opties delegate mee te geven aan de AddSignalR-aanroep in Startup.ConfigureServices.

public void ConfigureServices(IServiceCollection services)
{
    services.AddSignalR(hubOptions =>
    {
        hubOptions.EnableDetailedErrors = true;
        hubOptions.KeepAliveInterval = TimeSpan.FromMinutes(1);
    });
}

Opties voor een enkele hub overschrijven de algemene opties die zijn opgegeven in AddSignalR en kunnen worden ingesteld met behulp van AddHubOptions:

services.AddSignalR().AddHubOptions<ChatHub>(options =>
{
    options.EnableDetailedErrors = true;
});

Geavanceerde HTTP-configuratieopties

Hiermee HttpConnectionDispatcherOptions configureert u geavanceerde instellingen met betrekking tot transporten en geheugenbufferbeheer. Deze opties worden geconfigureerd door een gemachtigde door te geven aan MapHub in Startup.Configure.

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    app.UseRouting();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapHub<ChatHub>("/chathub", options =>
        {
            options.Transports =
                HttpTransportType.WebSockets |
                HttpTransportType.LongPolling;
        });
    });
}

In de volgende tabel worden opties beschreven voor het configureren van de geavanceerde HTTP-opties van ASP.NET Core SignalR:

Het long polling-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de LongPolling eigenschap:

Het WebSocket-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de WebSockets eigenschap:

Clientopties configureren

Clientopties kunnen worden geconfigureerd voor het HubConnectionBuilder type (beschikbaar in de .NET- en JavaScript-clients). Het is ook beschikbaar in de Java-client, maar de HttpHubConnectionBuilder subklasse bevat de opbouwconfiguratieopties, evenals op de HubConnection zelf.

Logboekregistratie configureren

Logboekregistratie wordt geconfigureerd in de .NET-client met behulp van de ConfigureLogging methode. Providers en filters voor logboekregistratie kunnen op dezelfde manier worden geregistreerd als op de server. Zie de Logging in ASP.NET Core-documentatie voor meer informatie.

Als u bijvoorbeeld consolelogboekregistratie wilt inschakelen, installeert u het Microsoft.Extensions.Logging.Console NuGet-pakket. Roep de AddConsole extensiemethode aan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub")
    .ConfigureLogging(logging => {
        logging.SetMinimumLevel(LogLevel.Information);
        logging.AddConsole();
    })
    .Build();

In de JavaScript-client bestaat een vergelijkbare configureLogging methode. Geef een LogLevel waarde op die het minimale niveau van logboekberichten aangeeft dat moet worden geproduceerd. Logs worden naar het consolevenster van de browser geschreven.

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .configureLogging(signalR.LogLevel.Information)
    .build();

In plaats van een LogLevel waarde kunt u ook een waarde opgeven die een string naam op logboekniveau vertegenwoordigt. Dit is handig bij het configureren van SignalR logboekregistratie in omgevingen waar u geen toegang hebt tot de LogLevel constanten.

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .configureLogging("warn")
    .build();

De volgende tabel bevat de beschikbare logboekniveaus. De waarde die u aan configureLogging opgeeft, stelt het minimale logboekniveau in dat wordt vastgelegd. Berichten die op dit niveau zijn geregistreerd , of de niveaus die erna in de tabel worden vermeld, worden geregistreerd.

Zie de SignalR documentatie over diagnostische gegevens voor meer informatie over logboekregistratie.

De SignalR Java-client maakt gebruik van de SLF4J-bibliotheek voor logboekregistratie. Het is een API voor logboekregistratie op hoog niveau waarmee gebruikers van de bibliotheek hun eigen specifieke implementatie voor logboekregistratie kunnen kiezen door een specifieke afhankelijkheid voor logboekregistratie in te voeren. In het volgende codefragment ziet u hoe u dit kunt gebruiken java.util.logging met de SignalR Java-client.

implementation 'org.slf4j:slf4j-jdk14:1.7.25'

Als u het loggen in uw afhankelijkheden niet configureert, laadt SLF4J een standaard geen-operatie logger met het volgende waarschuwingsbericht:

SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

Dit kan veilig worden genegeerd.

Toegestane transporten configureren

De transporten die door SignalR worden gebruikt, kunnen worden geconfigureerd in de functieaanroep WithUrl (withUrl in JavaScript). Een bitwise-OR van de waarden van HttpTransportType kan worden gebruikt om de client te beperken tot alleen de opgegeven transporten. Alle transporten zijn standaard ingeschakeld.

Als u bijvoorbeeld het transport van Server-Sent gebeurtenissen wilt onderbreken, maar WebSockets- en Long Polling-verbindingen wilt toestaan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", HttpTransportType.WebSockets | HttpTransportType.LongPolling)
    .Build();

In de JavaScript-client worden transporten geconfigureerd door het transport veld in te stellen op het optiesobject dat is opgegeven op withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", { transport: signalR.HttpTransportType.WebSockets | signalR.HttpTransportType.LongPolling })
    .build();

In deze versie van de Java-client WebSockets is het enige beschikbare transport.

In de Java-client wordt het transport geselecteerd met de withTransport methode op de HttpHubConnectionBuilder. De Java-client maakt standaard gebruik van het WebSockets-transport.

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
    .withTransport(TransportEnum.WEBSOCKETS)
    .build();

Bearer-verificatie configureren

Als u verificatiegegevens samen met SignalR aanvragen wilt opgeven, gebruikt u de AccessTokenProvider optie (accessTokenFactory in JavaScript) om een functie op te geven die het gewenste toegangstoken retourneert. In de .NET-client wordt dit toegangstoken doorgegeven als een HTTP-"Bearer Authenticatie"-token (met behulp van de Authorization header met een type Bearer). In de JavaScript-client wordt het toegangstoken gebruikt als een Bearer-token, behalve in enkele gevallen waarin browser-API's de mogelijkheid beperken om headers toe te passen (met name in Server-Sent Gebeurtenissen en WebSockets-aanvragen). In deze gevallen wordt het toegangstoken geleverd als een querytekenreekswaarde access_token.

In de .NET-client kan de AccessTokenProvider optie worden opgegeven met behulp van de gedelegeerde opties in WithUrl:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.AccessTokenProvider = async () => {
            // Get and return the access token.
        };
    })
    .Build();

In de JavaScript-client wordt het toegangstoken geconfigureerd door het accessTokenFactory veld in te stellen op het object Opties in withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        accessTokenFactory: () => {
            // Get and return the access token.
            // This function can return a JavaScript Promise if asynchronous
            // logic is required to retrieve the access token.
        }
    })
    .build();

In de SignalR Java-client kunt u een bearer-token configureren voor verificatie door een toegangstokenfactory op te geven voor httpHubConnectionBuilder. Gebruik withAccessTokenFactory om een RxJavaSingle<String> op te geven. Met een aanroep naar Single.defer kunt u logica schrijven om toegangstokens voor uw client te produceren.

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
    .withAccessTokenProvider(Single.defer(() -> {
        // Your logic here.
        return Single.just("An Access Token");
    })).build();

Time-out en keep-alive-opties configureren

Aanvullende opties voor het configureren van time-out en keep-alive-gedrag zijn beschikbaar op het HubConnection object zelf:

Aanvullende opties configureren

Aanvullende opties kunnen worden geconfigureerd in de WithUrl methode (withUrl in JavaScript) op HubConnectionBuilder of in de verschillende configuratie-API's op de HttpHubConnectionBuilder Java-client:

In de .NET-client kunnen deze opties worden gewijzigd door de optiedelegaat die is opgegeven voor WithUrl.

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.Headers["Foo"] = "Bar";
        options.SkipNegotiation = true;
        options.Transports = HttpTransportType.WebSockets;
        options.Cookies.Add(new Cookie(/* ... */);
        options.ClientCertificates.Add(/* ... */);
    })
    .Build();

In de JavaScript-client kunnen deze opties worden opgegeven in een JavaScript-object dat wordt geleverd aan withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        // "Foo: Bar" will not be sent with WebSockets or Server-Sent Events requests
        headers: { "Foo": "Bar" },
        transport: signalR.HttpTransportType.LongPolling 
    })
    .build();

In de Java-client kunnen deze opties worden geconfigureerd met de methoden op het door de HttpHubConnectionBuilder geretourneerde HubConnectionBuilder.create("HUB URL").

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
        .withHeader("Foo", "Bar")
        .shouldSkipNegotiate(true)
        .withHandshakeResponseTimeout(30*1000)
        .build();

Aanvullende bronnen

• Aan de slag met ASP.NET Core-SignalR
• Hubs gebruiken in ASP.NET Core SignalR
• ASP.NET Core SignalR JavaScript-client
• ASP.NET Core SignalR .NET-client
• MessagePack Hub Protocol gebruiken voor SignalR ASP.NET Core
• ASP.NET Core SignalR ondersteunde platforms

Serialisatieopties voor JSON/MessagePack

ASP.NET Core SignalR ondersteunt twee protocollen voor het coderen van berichten: JSON en MessagePack. Elk protocol heeft serialisatieconfiguratieopties.

JSON-serialisatie kan worden geconfigureerd op de server met behulp van de AddJsonProtocol extensiemethode. AddJsonProtocol kan worden toegevoegd na AddSignalR in Program.cs. De AddJsonProtocol methode gebruikt een gemachtigde die een options object ontvangt. De PayloadSerializerOptions eigenschap op dat object is een System.Text.JsonJsonSerializerOptions object dat kan worden gebruikt voor het configureren van serialisatie van argumenten en retourwaarden. Zie de documentatie system.Text.Json voor meer informatie.

Als u bijvoorbeeld de serializer wilt configureren om het hoofdlettergebruik van eigenschapsnamen niet te wijzigen, in plaats van de standaard camelCase kunt u de volgende code in Program.cs gebruiken:

builder.Services.AddSignalR()
    .AddJsonProtocol(options => {
        options.PayloadSerializerOptions.PropertyNamingPolicy = null;
    });

In de .NET-client bestaat dezelfde AddJsonProtocol extensiemethode op HubConnectionBuilder. De Microsoft.Extensions.DependencyInjection naamruimte moet worden geïmporteerd om de extensiemethode op te lossen:

// At the top of the file:
using Microsoft.Extensions.DependencyInjection;

// When constructing your connection:
var connection = new HubConnectionBuilder()
    .AddJsonProtocol(options => {
        options.PayloadSerializerOptions.PropertyNamingPolicy = null;
    })
    .Build();

Overschakelen naar Newtonsoft.Json

Zie Newtonsoft.Json als u functies van System.Text.Json nodig hebt die niet worden ondersteund in Newtonsoft.Json.

Serialisatieopties voor MessagePack

MessagePack-serialisatie kan worden geconfigureerd door een delegate te verstrekken aan de AddMessagePackProtocol oproep. Zie MessagePack in SignalR voor meer informatie.

Serveropties configureren

In de volgende tabel worden opties beschreven voor het configureren van SignalR hubs:

Opties kunnen worden geconfigureerd voor alle hubs door een opties delegate mee te geven aan de AddSignalR-aanroep in Program.cs.

builder.Services.AddSignalR(hubOptions =>
{
    hubOptions.EnableDetailedErrors = true;
    hubOptions.KeepAliveInterval = TimeSpan.FromMinutes(1);
});

Opties voor een enkele hub overschrijven de algemene opties die zijn opgegeven in AddSignalR en kunnen worden ingesteld met behulp van AddHubOptions:

builder.Services.AddSignalR().AddHubOptions<ChatHub>(options =>
{
    options.EnableDetailedErrors = true;
});

Geavanceerde HTTP-configuratieopties

Hiermee HttpConnectionDispatcherOptions configureert u geavanceerde instellingen met betrekking tot transporten en geheugenbufferbeheer. Deze opties worden geconfigureerd door een gemachtigde door te geven aan MapHub in Program.cs.

using Microsoft.AspNetCore.Http.Connections;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddSignalR();

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();
app.MapHub<ChatHub>("/chathub", options =>
{
    options.Transports =
        HttpTransportType.WebSockets |
        HttpTransportType.LongPolling;
}
);
app.Run();

In de volgende tabel worden opties beschreven voor het configureren van de geavanceerde HTTP-opties van ASP.NET Core SignalR:

Het long polling-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de LongPolling eigenschap:

Het WebSocket-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de WebSockets eigenschap:

Clientopties configureren

Clientopties kunnen worden geconfigureerd voor het HubConnectionBuilder type (beschikbaar in de .NET- en JavaScript-clients). Het is ook beschikbaar in de Java-client, maar de HttpHubConnectionBuilder subklasse bevat de opbouwconfiguratieopties, evenals op de HubConnection zelf.

Logboekregistratie configureren

Logboekregistratie wordt geconfigureerd in de .NET-client met behulp van de ConfigureLogging methode. Providers en filters voor logboekregistratie kunnen op dezelfde manier worden geregistreerd als op de server. Zie de Logging in ASP.NET Core-documentatie voor meer informatie.

Als u bijvoorbeeld consolelogboekregistratie wilt inschakelen, installeert u het Microsoft.Extensions.Logging.Console NuGet-pakket. Roep de AddConsole extensiemethode aan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub")
    .ConfigureLogging(logging => {
        logging.SetMinimumLevel(LogLevel.Information);
        logging.AddConsole();
    })
    .Build();

In de JavaScript-client bestaat een vergelijkbare configureLogging methode. Geef een LogLevel waarde op die het minimale niveau van logboekberichten aangeeft dat moet worden geproduceerd. Logs worden naar het consolevenster van de browser geschreven.

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .configureLogging(signalR.LogLevel.Information)
    .build();

In plaats van een LogLevel waarde kunt u ook een waarde opgeven die een string naam op logboekniveau vertegenwoordigt. Dit is handig bij het configureren van SignalR logboekregistratie in omgevingen waar u geen toegang hebt tot de LogLevel constanten.

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .configureLogging("warn")
    .build();

De volgende tabel bevat de beschikbare logboekniveaus. De waarde die u aan configureLogging opgeeft, stelt het minimale logboekniveau in dat wordt vastgelegd. Berichten die op dit niveau zijn geregistreerd , of de niveaus die erna in de tabel worden vermeld, worden geregistreerd.

Zie de SignalR documentatie over diagnostische gegevens voor meer informatie over logboekregistratie.

De SignalR Java-client maakt gebruik van de SLF4J-bibliotheek voor logboekregistratie. Het is een API voor logboekregistratie op hoog niveau waarmee gebruikers van de bibliotheek hun eigen specifieke implementatie voor logboekregistratie kunnen kiezen door een specifieke afhankelijkheid voor logboekregistratie in te voeren. In het volgende codefragment ziet u hoe u dit kunt gebruiken java.util.logging met de SignalR Java-client.

implementation 'org.slf4j:slf4j-jdk14:1.7.25'

Als u het loggen in uw afhankelijkheden niet configureert, laadt SLF4J een standaard geen-operatie logger met het volgende waarschuwingsbericht:

SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

Dit kan veilig worden genegeerd.

Toegestane transporten configureren

De transporten die door SignalR worden gebruikt, kunnen worden geconfigureerd in de functieaanroep WithUrl (withUrl in JavaScript). Een bitwise-OR van de waarden van HttpTransportType kan worden gebruikt om de client te beperken tot alleen de opgegeven transporten. Alle transporten zijn standaard ingeschakeld.

Als u bijvoorbeeld het transport van Server-Sent gebeurtenissen wilt onderbreken, maar WebSockets- en Long Polling-verbindingen wilt toestaan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", HttpTransportType.WebSockets | HttpTransportType.LongPolling)
    .Build();

In de JavaScript-client worden transporten geconfigureerd door het transport veld in te stellen op het optiesobject dat is opgegeven op withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", { transport: signalR.HttpTransportType.WebSockets | signalR.HttpTransportType.LongPolling })
    .build();

In deze versie van de Java-client WebSockets is het enige beschikbare transport.

In de Java-client wordt het transport geselecteerd met de withTransport methode op de HttpHubConnectionBuilder. De Java-client maakt standaard gebruik van het WebSockets-transport.

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
    .withTransport(TransportEnum.WEBSOCKETS)
    .build();

Bearer-verificatie configureren

Als u verificatiegegevens samen met SignalR aanvragen wilt opgeven, gebruikt u de AccessTokenProvider optie (accessTokenFactory in JavaScript) om een functie op te geven die het gewenste toegangstoken retourneert. In de .NET-client wordt dit toegangstoken doorgegeven als een HTTP-"Bearer Authenticatie"-token (met behulp van de Authorization header met een type Bearer). In de JavaScript-client wordt het toegangstoken gebruikt als een Bearer-token, behalve in enkele gevallen waarin browser-API's de mogelijkheid beperken om headers toe te passen (met name in Server-Sent Gebeurtenissen en WebSockets-aanvragen). In deze gevallen wordt het toegangstoken geleverd als een querytekenreekswaarde access_token.

In de .NET-client kan de AccessTokenProvider optie worden opgegeven met behulp van de gedelegeerde opties in WithUrl:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.AccessTokenProvider = async () => {
            // Get and return the access token.
        };
    })
    .Build();

In de JavaScript-client wordt het toegangstoken geconfigureerd door het accessTokenFactory veld in te stellen op het object Opties in withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        accessTokenFactory: () => {
            // Get and return the access token.
            // This function can return a JavaScript Promise if asynchronous
            // logic is required to retrieve the access token.
        }
    })
    .build();

In de SignalR Java-client kunt u een bearer-token configureren voor verificatie door een toegangstokenfactory op te geven voor httpHubConnectionBuilder. Gebruik withAccessTokenFactory om een RxJavaSingle<String> op te geven. Met een aanroep naar Single.defer kunt u logica schrijven om toegangstokens voor uw client te produceren.

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
    .withAccessTokenProvider(Single.defer(() -> {
        // Your logic here.
        return Single.just("An Access Token");
    })).build();

Time-out en keep-alive-opties configureren

Aanvullende opties voor het configureren van time-out en keep-alive-gedrag zijn beschikbaar op het HubConnection object zelf:

Aanvullende opties configureren

Aanvullende opties kunnen worden geconfigureerd in de WithUrl methode (withUrl in JavaScript) op HubConnectionBuilder of in de verschillende configuratie-API's op de HttpHubConnectionBuilder Java-client:

In de .NET-client kunnen deze opties worden gewijzigd door de optiedelegaat die is opgegeven voor WithUrl.

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.Headers["Foo"] = "Bar";
        options.SkipNegotiation = true;
        options.Transports = HttpTransportType.WebSockets;
        options.Cookies.Add(new Cookie(/* ... */);
        options.ClientCertificates.Add(/* ... */);
    })
    .Build();

In de JavaScript-client kunnen deze opties worden opgegeven in een JavaScript-object dat wordt geleverd aan withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        // "Foo: Bar" will not be sent with WebSockets or Server-Sent Events requests
        headers: { "Foo": "Bar" },
        transport: signalR.HttpTransportType.LongPolling 
    })
    .build();

In de Java-client kunnen deze opties worden geconfigureerd met de methoden op het door de HttpHubConnectionBuilder geretourneerde HubConnectionBuilder.create("HUB URL").

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
        .withHeader("Foo", "Bar")
        .shouldSkipNegotiate(true)
        .withHandshakeResponseTimeout(30*1000)
        .build();

Aanvullende bronnen

• Aan de slag met ASP.NET Core-SignalR
• Hubs gebruiken in ASP.NET Core SignalR
• ASP.NET Core SignalR JavaScript-client
• ASP.NET Core SignalR .NET-client
• MessagePack Hub Protocol gebruiken voor SignalR ASP.NET Core
• ASP.NET Core SignalR ondersteunde platforms

Serialisatieopties voor JSON/MessagePack

ASP.NET Core SignalR ondersteunt twee protocollen voor het coderen van berichten: JSON en MessagePack. Elk protocol heeft serialisatieconfiguratieopties.

JSON-serialisatie kan worden geconfigureerd op de server met behulp van de AddJsonProtocol extensiemethode. AddJsonProtocol kan worden toegevoegd na AddSignalR in Startup.ConfigureServices. De AddJsonProtocol methode gebruikt een gemachtigde die een options object ontvangt. De PayloadSerializerOptions eigenschap op dat object is een System.Text.JsonJsonSerializerOptions object dat kan worden gebruikt voor het configureren van serialisatie van argumenten en retourwaarden. Zie de documentatie system.Text.Json voor meer informatie.

Als u bijvoorbeeld de serializer wilt configureren om het hoofdlettergebruik van eigenschapsnamen niet te wijzigen, in plaats van de standaard camelCase kunt u de volgende code in Program.cs gebruiken:

builder.Services.AddSignalR()
    .AddJsonProtocol(options => {
        options.PayloadSerializerOptions.PropertyNamingPolicy = null;
    });

In de .NET-client bestaat dezelfde AddJsonProtocol extensiemethode op HubConnectionBuilder. De Microsoft.Extensions.DependencyInjection naamruimte moet worden geïmporteerd om de extensiemethode op te lossen:

// At the top of the file:
using Microsoft.Extensions.DependencyInjection;

// When constructing your connection:
var connection = new HubConnectionBuilder()
    .AddJsonProtocol(options => {
        options.PayloadSerializerOptions.PropertyNamingPolicy = null;
    })
    .Build();

Overschakelen naar Newtonsoft.Json

Zie Newtonsoft.Json als u functies van System.Text.Json nodig hebt die niet worden ondersteund in Newtonsoft.Json.

Serialisatieopties voor MessagePack

MessagePack-serialisatie kan worden geconfigureerd door een delegate te verstrekken aan de AddMessagePackProtocol oproep. Zie MessagePack in SignalR voor meer informatie.

Serveropties configureren

In de volgende tabel worden opties beschreven voor het configureren van SignalR hubs:

Opties kunnen worden geconfigureerd voor alle hubs door een opties delegate mee te geven aan de AddSignalR-aanroep in Program.cs.

 builder.Services.AddSignalR(hubOptions =>
 {
     hubOptions.EnableDetailedErrors = true;
     hubOptions.KeepAliveInterval = TimeSpan.FromMinutes(1);
 });

Opties voor een enkele hub overschrijven de algemene opties die zijn opgegeven in AddSignalR en kunnen worden ingesteld met behulp van AddHubOptions:

builder.Services.AddSignalR().AddHubOptions<ChatHub>(options =>
{
    options.EnableDetailedErrors = true;
});

Geavanceerde HTTP-configuratieopties

Hiermee HttpConnectionDispatcherOptions configureert u geavanceerde instellingen met betrekking tot transporten en geheugenbufferbeheer. Deze opties worden geconfigureerd door een gemachtigde door te geven aan MapHub in Program.cs.

using Microsoft.AspNetCore.Http.Connections;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddSignalR();

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();
app.MapHub<ChatHub>("/chathub", options =>
{
    options.Transports =
        HttpTransportType.WebSockets |
        HttpTransportType.LongPolling;
}
);
app.Run();

In de volgende tabel worden opties beschreven voor het configureren van de geavanceerde HTTP-opties van ASP.NET Core SignalR:

Het long polling-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de LongPolling eigenschap:

Het WebSocket-transport heeft extra opties die kunnen worden geconfigureerd met behulp van de WebSockets eigenschap:

Clientopties configureren

Clientopties kunnen worden geconfigureerd voor het HubConnectionBuilder type (beschikbaar in de .NET- en JavaScript-clients). Het is ook beschikbaar in de Java-client, maar de HttpHubConnectionBuilder subklasse bevat de opbouwconfiguratieopties, evenals op de HubConnection zelf.

Logboekregistratie configureren

Logboekregistratie wordt geconfigureerd in de .NET-client met behulp van de ConfigureLogging methode. Providers en filters voor logboekregistratie kunnen op dezelfde manier worden geregistreerd als op de server. Zie de Logging in ASP.NET Core-documentatie voor meer informatie.

Als u bijvoorbeeld consolelogboekregistratie wilt inschakelen, installeert u het Microsoft.Extensions.Logging.Console NuGet-pakket. Roep de AddConsole extensiemethode aan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub")
    .ConfigureLogging(logging => {
        logging.SetMinimumLevel(LogLevel.Information);
        logging.AddConsole();
    })
    .Build();

In de JavaScript-client bestaat een vergelijkbare configureLogging methode. Geef een LogLevel waarde op die het minimale niveau van logboekberichten aangeeft dat moet worden geproduceerd. Logs worden naar het consolevenster van de browser geschreven.

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .configureLogging(signalR.LogLevel.Information)
    .build();

In plaats van een LogLevel waarde kunt u ook een waarde opgeven die een string naam op logboekniveau vertegenwoordigt. Dit is handig bij het configureren van SignalR logboekregistratie in omgevingen waar u geen toegang hebt tot de LogLevel constanten.

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .configureLogging("warn")
    .build();

De volgende tabel bevat de beschikbare logboekniveaus. De waarde die u aan configureLogging opgeeft, stelt het minimale logboekniveau in dat wordt vastgelegd. Berichten die op dit niveau zijn geregistreerd , of de niveaus die erna in de tabel worden vermeld, worden geregistreerd.

Zie de SignalR documentatie over diagnostische gegevens voor meer informatie over logboekregistratie.

De SignalR Java-client maakt gebruik van de SLF4J-bibliotheek voor logboekregistratie. Het is een API voor logboekregistratie op hoog niveau waarmee gebruikers van de bibliotheek hun eigen specifieke implementatie voor logboekregistratie kunnen kiezen door een specifieke afhankelijkheid voor logboekregistratie in te voeren. In het volgende codefragment ziet u hoe u dit kunt gebruiken java.util.logging met de SignalR Java-client.

implementation 'org.slf4j:slf4j-jdk14:1.7.25'

Als u het loggen in uw afhankelijkheden niet configureert, laadt SLF4J een standaard geen-operatie logger met het volgende waarschuwingsbericht:

SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

Dit kan veilig worden genegeerd.

Toegestane transporten configureren

De transporten die door SignalR worden gebruikt, kunnen worden geconfigureerd in de functieaanroep WithUrl (withUrl in JavaScript). Een bitwise-OR van de waarden van HttpTransportType kan worden gebruikt om de client te beperken tot alleen de opgegeven transporten. Alle transporten zijn standaard ingeschakeld.

Als u bijvoorbeeld het transport van Server-Sent gebeurtenissen wilt onderbreken, maar WebSockets- en Long Polling-verbindingen wilt toestaan:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", HttpTransportType.WebSockets | HttpTransportType.LongPolling)
    .Build();

In de JavaScript-client worden transporten geconfigureerd door het transport veld in te stellen op het optiesobject dat is opgegeven op withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", { transport: signalR.HttpTransportType.WebSockets | signalR.HttpTransportType.LongPolling })
    .build();

In deze versie van de Java-client WebSockets is het enige beschikbare transport.

In de Java-client wordt het transport geselecteerd met de withTransport methode op de HttpHubConnectionBuilder. De Java-client maakt standaard gebruik van het WebSockets-transport.

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
    .withTransport(TransportEnum.WEBSOCKETS)
    .build();

Bearer-verificatie configureren

Als u verificatiegegevens samen met SignalR aanvragen wilt opgeven, gebruikt u de AccessTokenProvider optie (accessTokenFactory in JavaScript) om een functie op te geven die het gewenste toegangstoken retourneert. In de .NET-client wordt dit toegangstoken doorgegeven als een HTTP-"Bearer Authenticatie"-token (met behulp van de Authorization header met een type Bearer). In de JavaScript-client wordt het toegangstoken gebruikt als een Bearer-token, behalve in enkele gevallen waarin browser-API's de mogelijkheid beperken om headers toe te passen (met name in Server-Sent Gebeurtenissen en WebSockets-aanvragen). In deze gevallen wordt het toegangstoken geleverd als een querytekenreekswaarde access_token.

In de .NET-client kan de AccessTokenProvider optie worden opgegeven met behulp van de gedelegeerde opties in WithUrl:

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.AccessTokenProvider = async () => {
            // Get and return the access token.
        };
    })
    .Build();

In de JavaScript-client wordt het toegangstoken geconfigureerd door het accessTokenFactory veld in te stellen op het object Opties in withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        accessTokenFactory: () => {
            // Get and return the access token.
            // This function can return a JavaScript Promise if asynchronous
            // logic is required to retrieve the access token.
        }
    })
    .build();

In de SignalR Java-client kunt u een bearer-token configureren voor verificatie door een toegangstokenfactory op te geven voor httpHubConnectionBuilder. Gebruik withAccessTokenFactory om een RxJavaSingle<String> op te geven. Met een aanroep naar Single.defer kunt u logica schrijven om toegangstokens voor uw client te produceren.

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
    .withAccessTokenProvider(Single.defer(() -> {
        // Your logic here.
        return Single.just("An Access Token");
    })).build();

Time-out en keep-alive-opties configureren

Aanvullende opties voor het configureren van time-out en keep-alive-gedrag zijn beschikbaar op het HubConnection object zelf:

Aanvullende opties configureren

Aanvullende opties kunnen worden geconfigureerd in de WithUrl methode (withUrl in JavaScript) op HubConnectionBuilder of in de verschillende configuratie-API's op de HttpHubConnectionBuilder Java-client:

In de .NET-client kunnen deze opties worden gewijzigd door de optiedelegaat die is opgegeven voor WithUrl.

var connection = new HubConnectionBuilder()
    .WithUrl("https://example.com/chathub", options => {
        options.Headers["Foo"] = "Bar";
        options.SkipNegotiation = true;
        options.Transports = HttpTransportType.WebSockets;
        options.Cookies.Add(new Cookie(/* ... */);
        options.ClientCertificates.Add(/* ... */);
    })
    .Build();

In de JavaScript-client kunnen deze opties worden opgegeven in een JavaScript-object dat wordt geleverd aan withUrl:

let connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub", {
        // "Foo: Bar" will not be sent with WebSockets or Server-Sent Events requests
        headers: { "Foo": "Bar" },
        transport: signalR.HttpTransportType.LongPolling 
    })
    .build();

In de Java-client kunnen deze opties worden geconfigureerd met de methoden op het door de HttpHubConnectionBuilder geretourneerde HubConnectionBuilder.create("HUB URL").

HubConnection hubConnection = HubConnectionBuilder.create("https://example.com/chathub")
        .withHeader("Foo", "Bar")
        .shouldSkipNegotiate(true)
        .withHandshakeResponseTimeout(30*1000)
        .build();

Aanvullende bronnen

• Aan de slag met ASP.NET Core-SignalR
• Hubs gebruiken in ASP.NET Core SignalR
• ASP.NET Core SignalR JavaScript-client
• ASP.NET Core SignalR .NET-client
• MessagePack Hub Protocol gebruiken voor SignalR ASP.NET Core
• ASP.NET Core SignalR ondersteunde platforms