Ajouter Azure SignalR en utilisant la fonctionnalité Services connectés de Visual Studio

Avec Visual Studio, vous pouvez connecter les éléments suivants à Azure SignalR Service en utilisant la fonctionnalité Services connectés :

  • Application console .NET Framework
  • ASP.NET Model-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
  • Cordova

La fonctionnalité de service connecté ajoute l’ensemble des références et du code de connexion nécessaires à votre projet, et modifie vos fichiers de configuration de manière appropriée.

Notes

Cette rubrique s’applique à Visual Studio sur Windows. Pour Visual Studio pour Mac, consultez Services connectés dans Visual Studio pour Mac.

Prérequis

Se connecter à Azure SignalR à l’aide des services connectés

  1. Ouvrez votre projet dans Visual Studio.

  2. 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é.

  3. Sous l’onglet Services connectés, sélectionnez l’icône + pour les Dépendances de service.

    Add Service Dependency

  4. Dans la page Ajouter une dépendance, sélectionnez Azure SignalR Service.

    Add Azure SignalR Service

    Si vous n’êtes pas déjà connecté, connectez-vous à votre compte Azure. Si vous n’en avez pas, vous pouvez demander un essai gratuit.

  5. Dans l’écran Configurer Azure SignalR, 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.

    Connect to existing Azure SignalR component

  6. Pour créer une instance d’Azure SignalR Service :

    1. Sélectionnez Créer une instance d’Azure SignalR Service au bas de l’écran.

    2. Renseignez l’écran Azure SignalR Service : Créer, puis sélectionnez Créer.

      New Azure SignalR Service instance

    3. Quand 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.

  7. Entrez un nom de chaîne de connexion, ou choisissez le nom par défaut, puis indiquez si vous souhaitez que la chaîne de connexion soit stockée dans un fichier de secrets local ou dans Azure Key Vault.

    Specify connection string

  8. 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.

    Summary of changes

  9. La connexion apparaît sous la section Dépendances de service de l’onglet Services connectés.

    Service dependencies

Se connecter à Azure SignalR à l’aide des services connectés

Note

Pour les projets .NET Framework, l’interface utilisateur de Services connectés est légèrement différente. Pour voir les différences, comparez à la version Visual Studio 2019 de cette page.

  1. Ouvrez votre projet dans Visual Studio.

  2. Dans Explorateur de solutions, cliquez avec le bouton de droite sur le nœud Services connectés, puis, dans le menu contextuel, sélectionnez Ajouter pour ouvrir le menu des services disponibles.

    Screenshot showing Connected Services context menu options.

  3. Choisissez Azure SignalR Service. La page Se connecter à la dépendance s’affiche.

    Screenshot showing Connect to dependency for Azure SignalR.

    Si vous n’êtes pas déjà connecté, connectez-vous à votre compte Azure. Si vous n’en avez pas, vous pouvez demander un essai gratuit.

  4. Sélectionnez un composant Azure SignalR existant, puis sélectionnez Suivant.

    Si vous devez créer un nouveau composant, passez à l’étape suivante. Sinon, passez à l’étape 7.

    Screenshot showing

  5. Pour créer une instance d’Azure SignalR Service :

    1. Sélectionnez Créer au milieu à droite de l’écran.

    2. Renseignez l’écran Azure SignalR Service : Créer, puis sélectionnez Créer.

      Screenshot showing

    3. Quand 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.

  6. Entrez un nom de chaîne de connexion, ou choisissez le nom par défaut, puis indiquez si vous souhaitez que la chaîne de connexion soit stockée dans un fichier de secrets local ou dans Azure Key Vault.

    Screenshot showing

  7. 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.

    Screenshot showing

  8. Dans 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 :

    Screenshot showing

    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

Passez maintenant au guide de démarrage rapide pour Azure SignalR. Vous pouvez ignorer la configuration initiale, car vous l’avez déjà faite, et commencer à la section Ajouter Azure SignalR à l’application web. Le code à utiliser varie selon votre version d’ASP.NET Core. Vous devrez peut-être modifier le code fourni dans le tutoriel pour correspondre à votre modèle de projet si votre version d’ASP.NET Core est différente de celle utilisée dans le guide de démarrage rapide.