Rövid útmutató: Csevegőszoba létrehozása ASP.NET és SignalR szolgáltatással

Az Azure SignalR szolgáltatás a SignalR-en alapul a ASP.NET Core 2.1-hez, amely nem 100%-ig kompatibilis ASP.NET SignalR-sel. Az Azure SignalR Szolgáltatás a legújabb ASP.NET Core-technológiák alapján ASP.NET SignalR-adatprotokollt. Ha az Azure SignalR szolgáltatást ASP.NET SignalR-hez használja, bizonyos ASP.NET SignalR-funkciók már nem támogatottak, például az Azure SignalR nem játssza vissza az üzeneteket az ügyfél újracsatlakozásakor. Emellett a Forever Frame-átvitel és a JSONP nem támogatott. Néhány kódmódosításra és a függő kódtárak megfelelő verziójára van szükség ahhoz, hogy ASP.NET SignalR-alkalmazás működjön a SignalR Szolgáltatással.

A ASP.NET SignalR és ASP.NET Core SignalR közötti funkció-összehasonlítás teljes listájáért tekintse meg a verzióeltéréseket ismertető dokumentumot .

Ebben a rövid útmutatóban megtudhatja, hogyan kezdheti el a ASP.NET és az Azure SignalR szolgáltatást egy hasonló csevegőszoba-alkalmazáshoz.

Ha nem rendelkezik Azure-előfizetéssel, első lépésként mindössze néhány perc alatt létrehozhat egy ingyenes fiókot.

Előfeltételek

• Visual Studio 2019
• .NET-keretrendszer 4.6.1
• ASP.NET SignalR 2.4.1

Problémákat tapasztal? Próbálja ki a hibaelhárítási útmutatót , vagy tudassa velünk.

Bejelentkezés az Azure-ba

Jelentkezzen be az Azure Portalra az Azure-fiókjával.

Problémákat tapasztal? Próbálja ki a hibaelhárítási útmutatót , vagy tudassa velünk.

Ebben a szakaszban egy alapszintű Azure SignalR-példányt hoz létre az alkalmazáshoz. Az alábbi lépések az Azure Portal használatával hoznak létre új példányt, de használhatja az Azure CLI-t is. További információ: az signalr create command in the Azure SignalR Service CLI Reference.

1. Jelentkezzen be az Azure Portalra.
2. A lap bal felső részén válassza az + Erőforrás létrehozása lehetőséget.
3. Az Erőforrás létrehozása lap Search szolgáltatás és piactér szövegmezőjében adja meg a signalr kifejezést, majd válassza ki a SignalR szolgáltatást a listából.
4. A SignalR szolgáltatás oldalán válassza a Létrehozás lehetőséget.
5. Az Alapok lapon adja meg az új SignalR-szolgáltatáspéldány alapvető adatait. Írja be a következő értékeket:

A SignalR-oktatóanyagok Hálózatkezelés és Címkék lapján nem kell módosítania a beállításokat.

6. Válassza az Alapismeretek lap alján található Véleményezés + létrehozás gombot.
7. A Véleményezés + létrehozás lapon tekintse át az értékeket, majd válassza a Létrehozás lehetőséget. Az üzembe helyezés végrehajtása néhány percet vesz igénybe.
8. Amikor az üzembe helyezés befejeződött, válassza az Erőforrás megnyitása gombot.
9. A SignalR erőforráslapján válassza a Bal oldali menü Beállítások területén található Kulcsok lehetőséget.
10. Másolja ki az elsődleges kulcs kapcsolati sztringét . Erre a kapcsolati sztring van szüksége az alkalmazás konfigurálásához az oktatóanyag későbbi részében.

A kiszolgáló nélküli mód nem támogatott ASP.NET SignalR-alkalmazások esetében. Mindig használja az Alapértelmezett vagy a Klasszikus értéket az Azure SignalR Szolgáltatáspéldányhoz.

Az ebben a rövid útmutatóban használt Azure-erőforrásokat a SignalR-szolgáltatás parancsfájljának létrehozásával is létrehozhatja.

Problémákat tapasztal? Próbálja ki a hibaelhárítási útmutatót , vagy tudassa velünk.

A mintaalkalmazás klónozása

Amíg a szolgáltatás üzembe helyezése folyamatban van, térjünk át a kóddal folytatott munkavégzésre. Klónozza a mintaalkalmazást a GitHubról, állítsa be a SignalR Service kapcsolati sztringjét, és futtassa helyileg az alkalmazást.

1. Nyisson meg egy git terminálablakot. Váltson át arra a mappára, ahová a mintaprojektet klónozni szeretné.

2. Az alábbi parancs futtatásával klónozhatja a mintatárházat. Ez a parancs másolatot hoz létre a mintaalkalmazásról az Ön számítógépén.

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

Problémákat tapasztal? Próbálja ki a hibaelhárítási útmutatót , vagy tudassa velünk.

Csevegőszoba webalkalmazás konfigurálása és futtatása

1. Indítsa el a Visual Studiót, és nyissa meg a megoldást a klónozott adattár aspnet-samples/ChatRoom/ mappájában.

2. A böngészőben, ahol az Azure Portal meg van nyitva, keresse meg és válassza ki a létrehozott példányt.

3. Válassza a Kulcsok elemet a SignalR-szolgáltatáspéldány kapcsolati sztringjeinek megtekintéséhez.

4. Válassza ki és másolja a vágólapra az elsődleges kapcsolati sztring értékét.

5. Most állítsa be a kapcsolati sztring a web.config fájlban.

   A cikkben szereplő nyers kapcsolati sztring csak bemutató célokra jelennek meg. Éles környezetben mindig védje a hozzáférési kulcsokat. Az Azure Key Vault használatával biztonságosan kezelheti és elforgathatja a kulcsokat, és biztonságossá teheti a kapcsolati sztring a Microsoft Entra-azonosítóval, és engedélyezheti a hozzáférést a Microsoft Entra-azonosítóval.

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

6. A Startup.cs a hívás MapSignalR()helyett kapcsolati sztring kell hívnia MapAzureSignalR({YourApplicationName}) és átadnia, hogy az alkalmazás a SignalR üzemeltetése helyett csatlakozzon a szolgáltatáshoz. Cserélje le {YourApplicationName} az alkalmazás nevére. Ez a név egy egyedi név, amely megkülönbözteti ezt az alkalmazást a többi alkalmazástól. Értékként is használható this.GetType().FullName .

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

   Ezen API-k használata előtt hivatkoznia kell a szolgáltatás SDK-jára is. Az Eszközök | megnyitása NuGet Csomagkezelő | Csomagkezelő Konzol és futtatás parancs:

   Install-Package Microsoft.Azure.SignalR.AspNet
   

   A módosításokon kívül minden más ugyanaz marad, továbbra is használhatja a már ismert központi felületet az üzleti logika írásához.

   Feljegyzés

   A megvalósítás során egy végpontot /signalr/negotiate az Azure SignalR Service SDK tárgyal. Különleges tárgyalási választ ad vissza, amikor az ügyfelek megpróbálnak csatlakozni az ügyfelekhez, és átirányítják az ügyfeleket a kapcsolati sztring definiált szolgáltatásvégpontra.

7. Nyomja le az F5 billentyűt a projekt hibakeresési módban való futtatásához. Láthatja, hogy az alkalmazás helyileg fut. A SignalR-futtatókörnyezet helyett most már az Azure SignalR szolgáltatáshoz csatlakozik.

Problémákat tapasztal? Próbálja ki a hibaelhárítási útmutatót , vagy tudassa velünk.

Az erőforrások eltávolítása

Ha nem használja tovább az alkalmazást, akkor a következő lépésekkel a mintaalkalmazás által létrehozott összes erőforrást törölheti a költségek elkerülése érdekében:

1. Az Azure Portalon válassza az Erőforráscsoportok lehetőséget a bal szélen, majd a létrehozott erőforráscsoport. Másik lehetőségként a keresőmezőben, név alapján is rákereshet az erőforráscsoportra.

2. Az ekkor megnyíló új ablakban válassza ki az erőforráscsoportot, és kattintson az Erőforráscsoport törlése elemre.

3. Az új ablakban írja be a törölni kívánt erőforráscsoport nevét, majd kattintson a Törlés elemre.

Jelentkezzen be az Azure Portalra, és válassza az Erőforráscsoportok elemet.

A Szűrés név alapján... mezőbe írja be az erőforráscsoport nevét. Ebben a rövid útmutatóban a SignalRTestResources nevű erőforráscsoportot használtuk. Az eredménylistában kattintson a … ikonra az erőforráscsoport mellett, majd kattintson az Erőforráscsoport törlése lehetőségre.

A rendszer néhány pillanaton belül törli az erőforráscsoportot és a benne foglalt erőforrásokat.

Problémákat tapasztal? Próbálja ki a hibaelhárítási útmutatót , vagy tudassa velünk.

Következő lépések

Ebben a rövid útmutatóban létrehozott egy új Azure SignalR Service-erőforrást, és egy ASP.NET webalkalmazással használta. A következő lépésben megtudhatja, hogyan fejleszthet valós idejű alkalmazásokat az Azure SignalR Service és a ASP.NET Core használatával.