Partager via


Ajouter Azure Cache pour Redis à l’aide des services connectés de Visual Studio

Avec Visual Studio, vous pouvez connecter les éléments suivants à Azure Cache pour Redis à l’aide de la fonctionnalité Services connectés :

  • Applications 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 Cache pour Redis à 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.

    Screenshot showing connected services selected in the menu pane. The + icon is highlighted for emphasis.

  4. Dans la page Ajouter une dépendance, sélectionnez Azure Cache pour Redis.

    Screenshot of the Add Dependency page. Azure Cache for Redis is selected.

    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 Cache pour Redis, sélectionnez un Azure Cache pour Redis existant, puis sélectionnez Suivant.

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

    Screenshot of the Configure Azure Cache for Redis screen. Next is highlighted.

  6. Créer un Cache Azure pour Redis :

    1. Sélectionnez Créer un nouveau Azure Cache pour Redis en bas de l’écran.

    2. Remplissez l’écran Azure Cache pour Redis : Créer un nouveau, puis sélectionnez Créer.

      Screenshot of the Azure Cache for Redis create new page. Create is highlighted.

    3. Lorsque l’écran Configurer Azure Cache pour Redis s’affiche, le nouveau cache apparaît dans la liste. Sélectionnez la nouvelle base de données 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.

    Screenshot of the Azure Cache for Redis connection information page. Next is highlighted.

  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.

    Screenshot of the Summary of changes page. Finish is highlighted.

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

    Screenshot showing a list of configured service dependencies.

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 Cache pour Redis. La page Se connecter à la dépendance s’affiche. Vous devriez voir deux options, l’une pour un émulateur local, Cache Redis sur le conteneur (local) et l’autre pour la connexion au service de Azure Cache pour Redis en direct. Vous pouvez réduire les coûts et simplifier le développement précoce en commençant par l’émulateur local. Vous pouvez migrer vers le service actif ultérieurement en répétant ces étapes et en choisissant l’autre option.

    Screenshot showing Azure Cache for Redis choices

    Si vous choisissez Azure Cache for Redis localement, cliquez sur Suivant pour accéder à l’écran Connexion au cache Redis sur le conteneur.

    Screenshot showing connection options for Azure Cache for Redis in a local container.

    Spécifiez le nom du conteneur, l’image du conteneur et les mappages de ports ou acceptez les valeurs par défaut, puis cliquez sur Suivant pour afficher l’écran Résumé des modifications, qui indique les modifications à apporter à votre projet. Une référence de package NuGet est ajoutée à votre projet et le code de connexion de l’émulateur local est ajouté à votre projet.

    Si vous souhaitez vous connecter au service Azure, passez à l’étape suivante ou, si vous n’êtes pas déjà connecté, connectez-vous à votre compte Azure avant de continuer. Si vous n’en avez pas, vous pouvez demander un essai gratuit.

  4. Pour utiliser le service en direct, sélectionnez Azure Cache pour Redis.

    Screenshot of the Add Dependency page. Azure Cache for Redis is selected.

    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 Cache pour Redis, sélectionnez un Azure Cache pour Redis existant, puis sélectionnez Suivant.

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

    Screenshot of the Configure Azure Cache for Redis screen. Next is highlighted.

  6. Créer un Cache Azure pour Redis :

    1. Sélectionnez Créer un nouveau Azure Cache pour Redis en bas de l’écran.

    2. Remplissez l’écran Azure Cache pour Redis : Créer un nouveau, puis sélectionnez Créer.

      Screenshot of the Azure Cache for Redis create new page. Create is highlighted.

    3. Lorsque l’écran Configurer Azure Cache pour Redis s’affiche, le nouveau cache apparaît dans la liste. Sélectionnez la nouvelle base de données 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.

    Screenshot of the Azure Cache for Redis connection information page. Next is highlighted.

  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.

    Screenshot of the Summary of changes page. Finish is highlighted.

  9. 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 a list of configured service dependencies.

    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

Pour les applications ASP.NET, les incidents courants d’utilisation d’Azure Cache for Redis sont la mise en cache de l’état de la session ou de la sortie de la page (réponses HTTP). Pour ces cas d’usage, ASP.NET Core fournit des services intégrés qui doivent être utilisés à la place lorsque vous utilisez ASP.NET Core.

Pour mettre en cache l’état de session dans une application ASP.NET, consultez Fournisseur d’état de session ASP.NET.

Pour mettre en cache la sortie de page dans une application ASP.NET, consultez Fournisseur de cache de sortie ASP.NET.