Quickstart: Een chatruimte maken met ASP.NET en SignalR Service

Azure SignalR Service is gebaseerd op SignalR voor ASP.NET Core 2.1. Dit is niet 100% compatibel met ASP.NET SignalR. Met Azure SignalR Service wordt het ASP.NET SignalR-gegevensprotocol opnieuw geïmplementeerd op basis van de meest recente ASP.NET Core-technologieën. Wanneer u Azure SignalR Service gebruikt voor ASP.NET SignalR, worden een aantal ASP.NET SignalR-functies niet langer ondersteund; met Azure SignalR worden berichten bijvoorbeeld niet opnieuw afgespeeld wanneer de client weer verbinding maakt. Ook worden Forever Frame-transport en JSONP niet ondersteund. Een aantal codewijzigingen en de juiste versie van afhankelijke bibliotheken zijn benodigd om ervoor te zorgen dat de ASP.NET SignalR-toepassing werkt met SignalR Service.

Raadpleeg het document met versieverschillen voor een complete lijst met functievergelijkingen tussen ASP.NET SignalR en ASP.NET Core SignalR.

In deze quickstart leert u hoe u aan de slag kunt gaan met ASP.NET en Azure SignalR Service voor een vergelijkbare Chatroom-toepassing.

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Vereisten

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

Ondervindt u problemen? Probeer de gids voor probleemoplossing of laat het ons weten.

Aanmelden bij Azure

Meld u met uw Azure-account aan bij Azure Portal.

Ondervindt u problemen? Probeer de gids voor probleemoplossing of laat het ons weten.

Een exemplaar van de Azure SignalR Service maken

Uw toepassing maakt verbinding met een SignalR-Service-exemplaar in Azure.

1. Selecteer de knop Nieuw in de linkerbovenhoek van Azure Portal. Typ in het scherm Nieuw SignalR Service in het zoekvak in en druk op Enter.

   

2. Selecteer SignalR Service in de zoekresultaten en selecteer Maken.

3. Voer de volgende instellingen in.

   Instelling	Voorgestelde waarde	Beschrijving
   Resourcenaam	Wereldwijd unieke naam	Naam ter identificatie van uw nieuwe SignalR Service-exemplaar. Geldige tekens zijn a-z, 0-9 en -.
   Abonnement	Uw abonnement	Het abonnement waarin dit nieuwe SignalR Service-exemplaar is gemaakt.
   Resourcegroep	myResourceGroup	Naam voor de nieuwe resourcegroep waarin het SignalR Service-exemplaar moet worden gemaakt.
   Locatie	VS - west	Kies een regio bij u in de buurt.
   Prijscategorie	Gratis	Probeer Azure SignalR Service gratis uit.
   Aantal eenheden	Niet van toepassing	Het aantal eenheden geeft aan hoeveel verbindingen uw SignalR Service-exemplaar kan accepteren. Dit kan alleen worden geconfigureerd in de Standard-laag.
   Servicemodus	Serverloos	Voor gebruik met Azure Functions of REST-API.

   

4. Selecteer Maken om te beginnen met het implementeren van het SignalR-Service-exemplaar.

5. Zodra het exemplaar is geïmplementeerd, opent u dit in de portal en zoekt u de bijbehorende Instellingen-pagina. Wijzig de instelling van Servicemodus alleen in Serverloos als u de Azure SignalR-service gebruikt via Azure Functions-binding of de REST-API. Laat de modus anders op Klassiek of Standaard staan.

De modus Serverloos wordt niet ondersteund voor ASP.NET SignalR-toepassingen. Gebruik altijd Standaard of Klassiek voor het Azure SignalR Service-exemplaar.

U kunt de Azure-resources die in deze quickstart worden gebruikt ook maken met Een SignalR Service-script maken.

Ondervindt u problemen? Probeer de gids voor probleemoplossing of laat het ons weten.

De voorbeeldtoepassing klonen

Terwijl de service wordt geïmplementeerd, gaan we met code werken. Kloon de voorbeeld-app vanuit GitHub, stel de SignalR Service-verbindingsreeks in en voer de toepassing lokaal uit.

1. Open een nieuw git-terminalvenster. Ga naar een map waarin u het voorbeeldproject wilt klonen.

2. Voer de volgende opdracht uit om de voorbeeldopslagplaats te klonen. Deze opdracht maakt een kopie van de voorbeeld-app op uw computer.

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

Ondervindt u problemen? Probeer de gids voor probleemoplossing of laat het ons weten.

Chatroom-web-app

1. Start Visual Studio en open de oplossing in de map aspnet-samples/ChatRoom/ van de gekloonde opslagplaats.

2. Zoek en selecteer het exemplaar dat u hebt gemaakt in de browser waarin Azure Portal is geopend.

3. Selecteer Sleutels om de verbindingsreeksen voor het service-exemplaar van SignalR weer te geven.

4. Selecteer en kopieer de primaire verbindingsreeks.

5. Stel nu in het bestand web.config de verbindingsreeks in.

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

6. In Startup.cs moet u niet MapSignalR() maar MapAzureSignalR({YourApplicationName}) aanroepen en de verbindingsreeks doorgeven om de toepassing verbinding te laten maken met de service in plaats van SignalR zelf te hosten. Vervang {YourApplicationName} door de naam van uw toepassing. Deze naam is een unieke naam waarmee u deze toepassing kunt onderscheiden van uw andere toepassingen. U kunt this.GetType().FullName als de waarde gebruiken.

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

   U moet ook verwijzen naar de service-SDK voordat u deze API's gebruikt. Open Extra > NuGet-pakketbeheer > Package Manager-console en voer de volgende opdracht uit:

   Install-Package Microsoft.Azure.SignalR.AspNet
   

   Met uitzondering van deze wijzigingen blijft de rest onveranderd; u kunt gebruik blijven maken van de hubinterface die u al kent om bedrijfslogica te schrijven.

   Notitie

   In de implementatie wordt een eindpunt /signalr/negotiate weergegeven voor onderhandeling door de Azure SignalR Service-SDK. Er wordt een speciaal onderhandelingsantwoord geretourneerd wanneer clients verbinding proberen te maken en clients proberen door te sturen naar het service-eindpunt dat in de verbindingsreeks is gedefinieerd.

7. Druk op F5 om het project uit te voeren in de foutopsporingsmodus. U kunt zien dat de toepassing lokaal wordt uitgevoerd. In plaats van een SignalR-runtime door de toepassing zelf te laten hosten, wordt nu verbinding gemaakt met de Azure SignalR Service.

Ondervindt u problemen? Probeer de gids voor probleemoplossing of laat het ons weten.

Resources opschonen

Als u deze app niet verder gaat gebruiken, kunt u alle resources verwijderen die door deze Quick Start zijn aangemaakt door de onderstaande stappen te volgen, zodat u geen kosten in rekening worden gebracht:

1. Selecteer in Azure Portal Resourcegroepen aan de linkerkant en selecteer vervolgens de resourcegroep die u hebt gemaakt. U kunt ook het zoekvak gebruiken om de resourcegroep op de naam te zoeken.

2. Selecteer in het venster dat wordt geopend, de resourcegroep en klik op Resourcegroep verwijderen.

3. Voer in het nieuwe venster de naam in van de resourcegroep die u wilt verwijderen en klik vervolgens op Verwijderen.

Meld u aan bij Azure Portal en klik op Resourcegroepen.

Typ de naam van de resourcegroep in het tekstvak Filteren op naam... . In de instructies voor deze snelstart is een resourcegroep met de naam SignalRTestResources gebruikt. Klik in de resourcegroep in de lijst met resultaten op ... en vervolgens op Resourcegroep verwijderen.

Na enkele ogenblikken worden de resourcegroep en alle resources in de groep verwijderd.

Ondervindt u problemen? Probeer de gids voor probleemoplossing of laat het ons weten.

Volgende stappen

In deze quickstart hebt u een nieuwe Azure SignalR Service-resource gemaakt en deze gebruikt voor een ASP.NET-web-app. Hierna leert u hoe u realtime toepassingen ontwikkelt met behulp van Azure SignalR Service met ASP.NET Core.