Hinzufügen von Azure Cache for Redis mithilfe von verbundenen Diensten in Visual Studio

Mit Visual Studio können Sie über die Funktion Verbundene Dienste eine Verbindung zwischen Azure Cache for Redis und jedem der folgenden Elemente herstellen:

  • .NET Framework-Konsolen-App
  • ASP.NET Model-View-Controller (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (einschließlich Konsolen-App, WPF, Windows Forms, Klassenbibliothek)
  • .NET Core-Workerrolle
  • Azure-Funktionen
  • App für Universelle Windows-Plattform
  • Xamarin
  • Cordova

Mit der Funktion für verbundene Dienste werden die benötigten Verweise und der Verbindungscode zu Ihrem Projekt hinzugefügt und Ihre Konfigurationsdateien entsprechend geändert.

Hinweis

Dieses Thema gilt für Visual Studio unter Windows. Informationen zu Visual Studio für Mac finden Sie unter Verbundene Dienste in Visual Studio für Mac.

Voraussetzungen

Herstellen einer Verbindung mit Azure Cache for Redis mithilfe von verbundenen Diensten

  1. Öffnen Sie Ihr Projekt in Visual Studio.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Knoten Verbundene Dienste, und wählen Sie im Kontextmenü die Option Verbundenen Dienst hinzufügen aus.

  3. Klicken Sie auf der Registerkarte Verbundene Dienste auf das Pluszeichen (+) für Dienstabhängigkeiten.

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

  4. Wählen Sie auf der Seite Abhängigkeit hinzufügen die Option Azure Cache for Redis aus.

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

    Wenn Sie noch nicht angemeldet sind, melden Sie sich bei Ihrem Azure-Konto an. Wenn Sie nicht über ein Azure-Konto verfügen, können Sie sich für eine kostenlose Testversionregistrieren.

  5. Wählen Sie auf dem Bildschirm Azure Cache for Redis konfigurieren einen vorhandenen Azure Cache for Redis und dann Weiter aus.

    Wenn Sie eine neue Komponente erstellen müssen, fahren Sie mit dem nächsten Schritt fort. Andernfalls fahren Sie mit Schritt 7 fort.

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

  6. So erstellen Sie einen Azure-Cache für Redis:

    1. Wählen Sie unten auf dem Bildschirm Neuen Azure Redis Cache erstellen aus.

    2. Füllen Sie den Azure Cache for Redis: Neu erstellen-Bildschirm aus und wählen Sie Erstellen aus.

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

    3. Wenn der Bildschirm Azure Cache for Redis konfigurieren angezeigt wird, erscheint der neue Cache in der Liste. Wählen Sie die neue Datenbank in der Liste, und dann Weiter aus.

  7. Geben Sie einen Namen für die Verbindungszeichenfolge ein oder wählen Sie den Standardwert, und wählen Sie aus, ob die Verbindungszeichenfolge in einer lokalen Geheimnisdatei oder in Azure Key Vault gespeichert werden soll.

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

  8. Auf dem Bildschirm Zusammenfassung der Änderungen werden alle Änderungen angezeigt, die an Ihrem Projekt vorgenommen werden, wenn Sie den Vorgang abschließen. Wenn die Änderungen korrekt sind, wählen Sie Fertig stellen aus.

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

  9. Die Verbindung wird im Abschnitt Dienstabhängigkeiten der Registerkarte Verbundene Dienste angezeigt.

    Screenshot showing a list of configured service dependencies.

Hinweis

Bei .NET Framework-Projekten unterscheidet sich die Benutzeroberfläche von Verbundene Dienste geringfügig. Um die Unterschiede zu sehen, vergleichen Sie sie mit der Visual Studio 2019-Version dieser Seite.

  1. Öffnen Sie Ihr Projekt in Visual Studio.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Knoten Verbundene Dienste, und wählen Sie im Kontextmenü Hinzufügen aus, um das Menü verfügbarer Dienste zu öffnen.

    Screenshot showing Connected Services context menu options.

  3. Wählen Sie Azure Cache for Redis aus. Die Seite Mit Abhängigkeit verbinden wird angezeigt. Es sollten zwei Optionen angezeigt werden: eine für einen lokalen Emulator, Redis Cache im Container (lokal), und eine für die Verbindung mit dem aktiven Azure Cache for Redis-Dienst. Sie können die Kosten senken und die frühe Entwicklung vereinfachen, indem Sie mit dem lokalen Emulator beginnen. Sie können später zum Livedienst migrieren, indem Sie diese Schritte wiederholen und die andere Option auswählen.

    Screenshot showing Azure Cache for Redis choices

    Wenn Sie den Azure Cache für Redis lokal auswählen, klicken Sie auf Next zum Bildschirm Connect to Redis cache on container.

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

    Geben Sie Containername, Containerimage und Portzuordnungen an, oder übernehmen Sie die Standardwerte, und klicken Sie auf Weiter, um den Bildschirm Zusammenfassung der Änderungen anzuzeigen, in dem angezeigt wird, welche Änderungen an Ihrem Projekt vorgenommen werden. Ihrem Projekt werden ein NuGet-Paketverweis und der Verbindungscode für den lokalen Emulator hinzugefügt.

    Wenn Sie eine Verbindung mit dem Azure-Dienst herstellen möchten, fahren Sie mit dem nächsten Schritt fort, oder melden Sie sich bei Ihrem Azure-Konto an, bevor Sie fortfahren, falls Sie noch nicht angemeldet sind. Wenn Sie nicht über ein Azure-Konto verfügen, können Sie sich für eine kostenlose Testversionregistrieren.

  4. Um zum Livedienst zu wechseln, wählen Sie Azure Cache for Redis aus.

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

    Wenn Sie noch nicht angemeldet sind, melden Sie sich bei Ihrem Azure-Konto an. Wenn Sie nicht über ein Azure-Konto verfügen, können Sie sich für eine kostenlose Testversionregistrieren.

  5. Wählen Sie auf dem Bildschirm Azure Cache for Redis konfigurieren einen vorhandenen Azure Cache for Redis und dann Weiter aus.

    Wenn Sie eine neue Komponente erstellen müssen, fahren Sie mit dem nächsten Schritt fort. Andernfalls fahren Sie mit Schritt 7 fort.

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

  6. So erstellen Sie einen Azure-Cache für Redis:

    1. Wählen Sie unten auf dem Bildschirm Neuen Azure Redis Cache erstellen aus.

    2. Füllen Sie den Azure Cache for Redis: Neu erstellen-Bildschirm aus und wählen Sie Erstellen aus.

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

    3. Wenn der Bildschirm Azure Cache for Redis konfigurieren angezeigt wird, erscheint der neue Cache in der Liste. Wählen Sie die neue Datenbank in der Liste, und dann Weiter aus.

  7. Geben Sie einen Namen für die Verbindungszeichenfolge ein oder wählen Sie den Standardwert, und wählen Sie aus, ob die Verbindungszeichenfolge in einer lokalen Geheimnisdatei oder in Azure Key Vault gespeichert werden soll.

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

  8. Auf dem Bildschirm Zusammenfassung der Änderungen werden alle Änderungen angezeigt, die an Ihrem Projekt vorgenommen werden, wenn Sie den Vorgang abschließen. Wenn die Änderungen korrekt sind, wählen Sie Fertig stellen aus.

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

  9. Doppelklicken Sie im Projektmappen-Explorer auf den Knoten Verbundene Dienste, um die Registerkarte Verbundene Dienste zu öffnen. Die Verbindung wird im Abschnitt Dienstabhängigkeiten angezeigt:

    Screenshot showing a list of configured service dependencies.

    Wenn Sie auf die drei Punkte neben der von Ihnen hinzugefügten Abhängigkeit klicken, werden verschiedene Optionen angezeigt, z. B. Verbinden, um den Assistenten erneut zu öffnen und die Verbindung zu ändern. Sie können auch oben rechts im Fenster auf die drei Punkte klicken, um Optionen zum Starten lokaler Abhängigkeiten, Ändern von Einstellungen und mehr anzuzeigen.

Nächste Schritte

Für ASP.NET-Anwendungen werden Azure Cache for Redis häufig zum Cachen von Sitzungsstatus oder Seitenausgaben (HTTP-Antworten) verwendet. ASP.NET Core bietet integrierte Dienste für diese Anwendungsfälle, die stattdessen verwendet werden sollten, wenn Sie ASP.NET Core verwenden.

Informationen zum Zwischenspeichern des Sitzungsstatus in einer ASP.NET-App finden Sie unter ASP.NET-Sitzungszustandanbieter.

Informationen zum Zwischenspeichern der Seitenausgabe in einer ASP.NET-App finden Sie unter ASP.NET Ausgabecacheanbieter.