C# Academy · leksjon

SignalR-huber og tilkoblinger

Opprett en SignalR-hub, koble den til i ASP.NET Core, og opprett WebSocket-tilkoblinger fra JavaScript- og .NET-klienter.

Leksjon 1 av 412 trinn

SignalR-huber og tilkoblinger er en gratis leksjon i C# Academy på CoddyKit. Dette er leksjon 1 av 4. Du kan lese hele leksjonen gratis nedenfor – og deretter øve praktisk i nettleseren med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Den er en del av læringsløpet i C# Academy, og fremdriften din synkroniseres mellom nettet og CoddyKit-appen. Kurset i C# Academy inneholder totalt 4 leksjoner.

Hva er SignalR?

SignalR er et ASP.NET Core-bibliotek som legger til sanntids, toveis kommunikasjon mellom servere og klienter. Det velger automatisk den beste transporten – WebSockets, Server-Sent Events eller Long Polling – basert på hva begge sider støtter.

Sette opp SignalR

Legg SignalR til i tjenestene og kartlegg et hub-endepunkt. En hub er en klasse som håndterer klienttilkoblinger og metodekall.

builder.Services.AddSignalR();

var app = builder.Build();

app.UseCors("AllowAll");
app.MapHub<ChatHub>("/hubs/chat");

app.Run();

Opprette en hub

Arv fra Hub. Klienter kaller hub-metoder. Egenskapen Context gir tilkoblingsinformasjon, og Clients lar deg sende meldinger tilbake.

using Microsoft.AspNetCore.SignalR;

public class ChatHub : Hub
{
    public async Task SendMessage(string user, string message)
    {
        // Broadcast to ALL connected clients
        await Clients.All.SendAsync("ReceiveMessage", user, message);
    }

    public override async Task OnConnectedAsync()
    {
        await Clients.Caller.SendAsync("Welcome",
            $"Connected as {Context.ConnectionId}");
        await base.OnConnectedAsync();
    }
}

JavaScript-klient

Den offisielle SignalR-klienten for JavaScript oppretter en tilkobling, registrerer hendelsesbehandlere og starter tilkoblingen. Metoder som er definert på huben, kan kalles fra JavaScript.

// npm install @microsoft/signalr
import * as signalR from "@microsoft/signalr";

const connection = new signalR.HubConnectionBuilder()
    .withUrl("/hubs/chat")
    .withAutomaticReconnect()
    .build();

connection.on("ReceiveMessage", (user, message) => {
    console.log(`${user}: ${message}`);
});

await connection.start();
await connection.invoke("SendMessage", "Alice", "Hello!");

.NET SignalR-klient

.NET-klienten fungerer på samme måte – nyttig for sanntidskommunikasjon mellom tjenester eller for skrivebords- og mobilapper.

// dotnet add package Microsoft.AspNetCore.SignalR.Client

var connection = new HubConnectionBuilder()
    .WithUrl("https://myapp.com/hubs/chat")
    .WithAutomaticReconnect()
    .Build();

connection.On<string, string>("ReceiveMessage", (user, msg) =>
    Console.WriteLine($"{user}: {msg}"));

await connection.StartAsync();
await connection.InvokeAsync("SendMessage", "Bot", "Connected!");

Sende til bestemte klienter

Egenskapen Clients har metoder for å målrette bestemte tilkoblinger, kallere eller alle tilkoblede klienter bortsett fra de angitte.

// To the caller only
await Clients.Caller.SendAsync("YouSaid", message);

// To a specific connection
await Clients.Client(connectionId).SendAsync("PrivateMsg", msg);

// To all except caller
await Clients.Others.SendAsync("ReceiveMessage", user, message);

// To multiple specific connections
await Clients.Clients(new[] { id1, id2 })
             .SendAsync("DirectMsg", msg);

Hub-kontekst: sende utenfor huben

Sett inn IHubContext<T> i tjenester eller bakgrunnsarbeidere for å sende meldinger utenfor hub-klassen – viktig for serverinitierte push-varsler.

public class NotificationService
{
    private readonly IHubContext<ChatHub> _hub;

    public NotificationService(IHubContext<ChatHub> hub) => _hub = hub;

    public async Task BroadcastAlertAsync(string alert)
    {
        // Send to all clients from a background service
        await _hub.Clients.All.SendAsync("SystemAlert", alert);
    }
}

Hendelser i tilkoblingens livssyklus

Overstyr OnConnectedAsync og OnDisconnectedAsync for å spore tilkoblinger, vedlikeholde tilstand eller rydde opp i ressurser.

public override async Task OnConnectedAsync()
{
    _connections.TryAdd(Context.ConnectionId, GetUserName());
    await Clients.All.SendAsync("UserJoined", GetUserName());
    await base.OnConnectedAsync();
}

public override async Task OnDisconnectedAsync(Exception? ex)
{
    _connections.TryRemove(Context.ConnectionId, out var user);
    await Clients.All.SendAsync("UserLeft", user);
    await base.OnDisconnectedAsync(ex);
}

private string GetUserName() =>
    Context.User?.Identity?.Name ?? Context.ConnectionId;

Automatisk tilkobling på nytt

Aktiver automatisk tilkobling på nytt på klienten for å håndtere midlertidige frakoblinger på en god måte. Du kan tilpasse forsinkelsene mellom nye forsøk.

// JavaScript client
const conn = new signalR.HubConnectionBuilder()
    .withUrl("/hubs/chat")
    .withAutomaticReconnect([0, 2000, 5000, 10000, 30000]) // retry delays in ms
    .build();

conn.onreconnecting(err => console.warn("Reconnecting...", err));
conn.onreconnected(id  => console.log("Reconnected:",    id));
conn.onclose(err       => console.error("Disconnected:", err));

Autentisering med SignalR

SignalR respekterer ASP.NET Core-autentiserings-middleware. Legg [Authorize] til hub-klassen, eller bruk JWT-behandleren som støtter tokener i spørringsstrengen (nødvendig for WebSocket-autentisering).

[Authorize]
public class PrivateHub : Hub
{
    public Task SendMessage(string msg)
    {
        var user = Context.User!.Identity!.Name;
        return Clients.All.SendAsync("Msg", user, msg);
    }
}

// JWT via query string (WebSocket requirement):
builder.Services.AddAuthentication().AddJwtBearer(opt =>
{
    opt.Events = new JwtBearerEvents
    {
        OnMessageReceived = ctx =>
        {
            var token = ctx.Request.Query["access_token"];
            if (!string.IsNullOrEmpty(token))
                ctx.Token = token;
            return Task.CompletedTask;
        }
    };
});

Hurtigsjekk

Hvordan sender du en SignalR-melding fra en bakgrunnstjeneste (utenfor hub-klassen)?

Oppsummering: SignalR-huber og tilkoblinger

Viktigste punkter:

  • SignalR velger automatisk den beste transporten (WebSockets, SSE, Long Polling)
  • Klienter kan kalle hub-metoder; Clients.* målretter bestemte mottakere
  • Sett inn IHubContext<T> for å sende meldinger utenfra huben
  • Overstyr OnConnectedAsync/OnDisconnectedAsync for å håndtere livssyklusen
  • Bruk withAutomaticReconnect() for robuste klienttilkoblinger
  • JWT-autentisering via spørringsstrengen kreves for WebSocket-tilkoblinger
Gratis å komme i gang

Lær deg C# med en AI-veileder – gratis

Skriv og kjør ekte kode i nettleseren, få umiddelbar hjelp fra en AI-veileder som er tilgjengelig døgnet rundt, og fortsett der du slapp – på nettet eller i appen.

Kurs
93
Leksjoner
346

Ofte stilte spørsmål

Er leksjonen «SignalR-huber og tilkoblinger» gratis?

Ja – hele teksten i «SignalR-huber og tilkoblinger» er gratis å lese her på nettet. For å øve interaktivt med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt, og for å låse opp resten av C# Academy-kurset, kan du oppgradere til CoddyKit PRO. Kurset i C# Academy inneholder totalt 4 leksjoner.

Hva lærer jeg i «SignalR-huber og tilkoblinger»?

Opprett en SignalR-hub, koble den til i ASP.NET Core, og opprett WebSocket-tilkoblinger fra JavaScript- og .NET-klienter. Du øver på C# Academy med praktisk kode som du kjører direkte i nettleseren, mens en AI-veileder som er tilgjengelig døgnet rundt, svarer på spørsmålene dine mens du jobber deg gjennom leksjonen.

Trenger jeg erfaring for å begynne med C# Academy?

Ingen tidligere erfaring er nødvendig. C# Academy på CoddyKit er lagt opp for både nybegynnere og viderekomne, så De kan begynne her eller helt fra start og lære i Deres eget tempo. Dette er leksjon 1 av 4.

Hvor lang tid tar leksjonen «SignalR-huber og tilkoblinger»?

De fleste CoddyKit-leksjoner tar omtrent 5–10 minutter. Hver leksjon er kort og interaktiv, slik at De gjør jevne fremskritt og kan fortsette akkurat der De slapp – både på nettet og i appen.

Kan jeg skrive og kjøre kode i denne C# Academy-leksjonen?

Ja. Alle C# Academy-leksjoner har en innebygd kodeeditor, slik at De kan skrive og kjøre ekte kode direkte i nettleseren og få umiddelbar tilbakemelding fra AI – uten lokal konfigurering.

Alle leksjonene i dette kurset

  1. SignalR-huber og tilkoblinger
  2. Grupper, brukere og tilkoblingshåndtering
  3. Sterkt typede huber
  4. Skalering med Redis-backplane
← Tilbake til C# Academy