Ajouter Azure SignalR à l’aide de Visual Studio Connected Services
Avec Visual Studio, vous pouvez connecter l’un des éléments suivants au service Azure SignalR à l’aide de la fonctionnalité Connected Services :
- Application console .NET Framework
- ASP.NET Modèle -View-Controller (MVC) (.NET Framework)
- ASP.NET Core
- .NET Core (y compris l’application console, WPF, Windows Forms, bibliothèque de classes)
- Rôle de travail .NET Core
- Azure Functions
- Application de plateforme Windows universelle
- Xamarin
- Cordoue
La fonctionnalité de service connecté ajoute toutes les références et le code de connexion nécessaires à votre projet et modifie vos fichiers de configuration de manière appropriée.
Conditions préalables
- Visual Studio avec la charge de travail Azure installée.
- Projet d’un des types pris en charge
- Un compte Azure. Si vous n’avez pas de compte Azure, activez vos avantages Azure pour les abonnés Visual Studio ou inscrivez-vous à un essai gratuit.
Se connecter à Azure SignalR à l’aide des services connectés
Ouvrez votre projet dans Visual Studio.
Dans l’Explorateur de solutions , cliquez avec le bouton droit sur le nœud Services connectés, puis, dans le menu contextuel, sélectionnez Ajouter un Service connecté.
Si vous ne voyez pas le nœud Services connectés, choisissez Projet>Services connectés>Ajouter.
Sous l’onglet Services connectés, sélectionnez l’icône + pour dépendances de service.
Dans la page Ajouter une dépendance, sélectionnez Azure SignalR Service.
Si vous n’êtes pas déjà connecté, connectez-vous à votre compte Azure. Si vous n’avez pas de compte Azure, vous pouvez vous inscrire à un essai gratuit .
Dans l'écran Configurer Azure SignalR, sélectionner un composant Azure SignalR existant, puis cliquer sur suivant.
Si vous devez créer un composant, passez à l’étape suivante. Sinon, passez à l’étape 7.
Pour créer une instance de service Azure SignalR :
Sélectionnez Créer une instance Azure SignalR Service en bas de l’écran.
Renseignez l’écran Azure SignalR Service : Créer, puis sélectionnez Créer.
Lorsque l’écran Configurer Azure SignalR Service s’affiche, la nouvelle instance apparaît dans la liste. Sélectionnez la nouvelle instance dans la liste, puis sélectionnez suivant.
Entrez un nom de chaîne de connexion, ou choisissez la valeur par défaut, puis indiquez si vous souhaitez que la chaîne de connexion soit stockée dans un fichier de secrets local, soit dans Azure Key Vault.
L’écran Résumé des modifications affiche toutes les modifications qui seront apportées à votre projet si vous terminez le processus. Si les modifications semblent correctes, choisissez Terminer.
La connexion apparaît sous la section Dépendances de service de l’onglet Services connectés.
dépendances de service
Se connecter à Azure SignalR à l’aide des services connectés
Remarque
Pour les projets .NET Framework, l’interface utilisateur des services connectés est légèrement différente. Pour voir les différences, comparez la version Visual Studio 2019 de cette page.
Ouvrez votre projet dans Visual Studio.
Dans explorateur de solutions, cliquez avec le bouton droit sur le nœud services connectés, puis, dans le menu contextuel, sélectionnez Ajouter pour ouvrir le menu des services disponibles.
Si vous ne voyez pas le nœud Services connectés, choisissez Projet>Services connectés>Ajouter.
Choisissez Azure SignalR Service. La page de connexion à la dépendance s’affiche.
Capture d’écran
Si vous n’êtes pas déjà connecté, connectez-vous à votre compte Azure. Si vous n’avez pas de compte Azure, vous pouvez vous inscrire à un essai gratuit .
Sélectionnez un composant Azure SignalR existant, puis sélectionnez Suivant.
Si vous devez créer un composant, passez à l’étape suivante. Sinon, passez à l’étape 7.
Pour créer une instance de service Azure SignalR :
Sélectionnez l'option Créer une nouvelle en haut à droite de l'écran.
Renseignez l’écran Azure SignalR Service : Créer, puis sélectionnez Créer.
Lorsque l’écran Configurer Azure SignalR Service s’affiche, la nouvelle instance apparaît dans la liste. Sélectionnez la nouvelle instance dans la liste, et sélectionnez Suivant.
Entrez un nom de paramètre de connexion ou acceptez la valeur par défaut.
Remarque
Pour améliorer la sécurité, dans Visual Studio 17.12 et versions ultérieures, cette étape crée un nom de paramètre de connexion ; les versions précédentes créent une chaîne de connexion. Les chaînes de connexion stockées dans le système de fichiers local peuvent entraîner un risque de sécurité, s’ils sont exposés par inadvertance.
Cliquez sur paramètres supplémentaires et choisissez si vous souhaitez que les informations de connexion soient stockées dans un fichier de secrets local, ou dans Azure Key Vault.
L'écran Résumé des modifications affiche toutes les modifications qui seront apportées à votre projet si vous terminez le processus. Si les modifications semblent correctes, choisissez Terminer.
Dans l’Explorateur de solutions, double-cliquez sur le nœud Services connectés pour ouvrir l’onglet Services connectés. La connexion apparaît sous la section dépendances de service :
Si vous cliquez sur les trois points en regard de la dépendance que vous avez ajoutée, vous pouvez voir différentes options telles que Se connecter pour rouvrir l’Assistant et modifier la connexion. Vous pouvez également cliquer sur les trois points en haut à droite de la fenêtre pour afficher les options permettant de démarrer les dépendances locales, de modifier les paramètres, etc.
Étapes suivantes
Continuez en suivant le guide de démarrage rapide Azure SignalR. Vous pouvez ignorer la configuration initiale, car vous l’avez déjà fait et continuer avec la section Ajouter Azure SignalR à l’application web. Le code que vous utilisez varie en fonction de votre version de ASP.NET Core. Vous devrez peut-être modifier le code dans le didacticiel pour qu’il corresponde à votre modèle de projet si votre version ASP.NET Core ne correspond pas à la version utilisée dans le guide de démarrage rapide.