Snabbstart: Skapa ett chattrum med ASP.NET och SignalR Service

Azure SignalR Service baseras på SignalR för ASP.NET Core 2.1, som inte är 100 % kompatibel med ASP.NET SignalR. Azure SignalR Service implementerat ett ASP.NET SignalR-dataprotokoll baserat på de senaste ASP.NET Core teknikerna. När du Azure SignalR Service för ASP.NET SignalR stöds inte längre vissa ASP.NET SignalR-funktioner, till exempel spelar Inte Azure SignalR upp meddelanden igen när klienten återansluter. Dessutom stöds inte Forever Frame-transport och JSONP. Vissa kodändringar och rätt version av beroende bibliotek krävs för att ASP.NET SignalR-programmet ska fungera SignalR Service.

Se dokumentet om versionsskillnader för en fullständig lista över funktionsjämförelser mellan ASP.NET SignalR och ASP.NET Core SignalR.

I den här snabbstarten lär du dig att komma igång med ASP.NET och Azure SignalR Service för ett liknande chattrumsprogram.

Om du inte har en Azure-prenumerationkan du skapa ett kostnads fritt konto innan du börjar.

Förutsättningar

• Visual Studio 2019
• .NET Framework 4.6.1
• ASP.NET SignalR 2.4.1

Har du problem? Prova felsökningsguiden eller berätta för oss.

Logga in på Azure

Logga in på Azure-portalen med ditt Azure-konto.

Har du problem? Prova felsökningsguiden eller berätta för oss.

Skapa en Azure SignalR Service-instans

Din app ansluter till en SignalR Service-instans i Azure.

1. Välj knappen Nytt högst upp till vänster i Azure-portalen. På sidan Nytt skriver du SignalR Service i sökrutan och trycker på RETUR.

   

2. Välj SignalR Service i sökresultatet och välj sedan Skapa.

3. Ange följande inställningar.

   Inställning	Föreslaget värde	Beskrivning
   Resurs namn	Globalt unikt namn	Namn som identifierar din nya SignalR Service-instans. Giltiga tecken är a-z, 0-9 och -.
   Prenumeration	Din prenumeration	Prenumerationen som den här nya SignalR Service-instansen har skapats i.
   Resursgrupp	myResourceGroup	Namnet på den nya resursgruppen som SignalR Service-instansen ska skapas i.
   Plats	USA, västra	Välj en region nära dig.
   Prisnivå	Kostnadsfri	Prova Azure SignalR Service kostnadsfritt.
   Antal enheter	Inte tillämpligt	Antal enheter anger hur många anslutningar som SignalR Service-instansen kan acceptera. Det kan bara konfigureras på Standard-nivån.
   Tjänstläge	Utan server	För användning med Azure Functions eller REST API.

   

4. Välj Skapa för att börja distribuera SignalR Service-instansen.

5. När instansen har distribuerats öppnar du den i portalen och letar upp dess inställnings sida. Ändra inställningen för tjänst läge till endast Server om du använder Azure SignalR-tjänsten via Azure Functions bindning eller REST API. Lämna det i klassiskt eller i annat fall.

Serverlöst läge stöds inte för ASP.NET SignalR-program. Använd alltid Standard eller Klassisk för Azure SignalR Service instansen.

Du kan också skapa Azure-resurser som används i den här snabbstarten med Skapa SignalR Service skript.

Har du problem? Prova felsökningsguiden eller berätta för oss.

Klona exempelprogrammet

Medan tjänsten distribueras tar vi och arbetar med koden. Klona exempelappen från GitHub, ange SignalR Service-anslutningssträngen och kör programmet lokalt.

1. Öppna ett git-terminalfönster. Byt till en mapp där du vill klona exempelprojektet.

2. Klona exempellagringsplatsen med följande kommando. Detta kommando skapar en kopia av exempelappen på din dator.

   git clone https://github.com/aspnet/AzureSignalR-samples.git
   

Har du problem? Prova felsökningsguiden eller berätta för oss.

Konfigurera och köra webbappen för chattrum

1. Starta Visual Studio och öppna lösningen i mappen aspnet-samples/ChatRoom/på den klonade lagringsplatsen.

2. I webbläsaren där Azure Portal öppnas, hittar och väljer du den instans som du skapade.

3. Välj Nycklar för att visa anslutningssträngarna för SignalR Service-instansen.

4. Markera och kopiera den primära anslutningssträngen.

5. Ange nu anslutningssträngen i web.configfilen.

   <configuration>
   <connectionStrings>
       <add name="Azure:SignalR:ConnectionString" connectionString="<Replace By Your Connection String>"/>
   </connectionStrings>
   ...
   </configuration>
   

6. I Startup.cs måste du, i stället för att anropa , anropa och skicka in anslutningssträngen för att programmet ska ansluta till tjänsten i stället för att vara värd MapSignalR() för MapAzureSignalR({YourApplicationName}) SignalR själv. Ersätt {YourApplicationName} med namnet på ditt program. Det här namnet är ett unikt namn för att skilja det här programmet från dina andra program. Du kan this.GetType().FullName använda som värde.

   public void Configuration(IAppBuilder app)
   {
       // Any connection or hub wire up and configuration should go here
       app.MapAzureSignalR(this.GetType().FullName);
   }
   

   Du måste också referera till tjänst-SDK innan du använder dessa API:er. Öppna verktygs-| NuGet Package Manager-| Package Manager-konsolen och kör kommandot:

   Install-Package Microsoft.Azure.SignalR.AspNet
   

   Förutom dessa ändringar förblir allt annat detsamma. Du kan fortfarande använda hubbgränssnittet som du redan är bekant med för att skriva affärslogik.

   Anteckning

   I implementeringen exponeras /signalr/negotiate en slutpunkt för förhandling av Azure SignalR Service SDK. Den returnerar ett särskilt förhandlingssvar när klienter försöker ansluta och omdirigera klienter till tjänstslutpunkten som definierats i anslutningssträngen.

7. Tryck på F5 för att köra projektet i felsökningsläge. Du kan se att programmet körs lokalt. I stället för att vara värd för en SignalR-körning av själva programmet, ansluter den nu till Azure SignalR Service.

Har du problem? Prova felsökningsguiden eller berätta för oss.

Rensa resurser

Om du inte planerar att fortsätta använda den här appen tar du bort alla resurser som skapades i snabbstarten med följande steg, så att inga kostnader uppstår:

1. Välj Resursgrupper i Azure Portal längst till vänster och välj sedan den resursgrupp du skapat. Du kan också använda sökrutan till att hitta resursgruppen efter dess namn.

2. Markera resursgruppen i fönstret som öppnas och klicka sedan på Ta bort resursgrupp.

3. I det nya fönstret, skriv namnet på resursgruppen som ska tas bort och klicka sedan på Ta bort.

Logga in på Azure Portal och klicka på Resursgrupper.

Skriv namnet på din resursgrupp i textrutan Filter by name... (Filtrera efter namn...). Anvisningarna för den här snabbstarten använde en resursgrupp med namnet SignalRTestResources. På din resursgrupp i resultatlistan klickar du på ... och därefter Ta bort resursgrupp.

Efter en liten stund tas resursgruppen och resurser som finns i den bort.

Har du problem? Prova felsökningsguiden eller berätta för oss.

Nästa steg

I den här snabbstarten skapade du en Azure SignalR Service resurs och använde den med en ASP.NET webbapp. Härnäst får du lära dig hur du utvecklar realtidsprogram med hjälp Azure SignalR Service med ASP.NET Core.