Freigeben über


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.

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.

    Wenn der Knoten Verbundene Dienste nicht angezeigt wird, wählen Sie Projekt>Verbundene Dienste>Hinzufügen aus.

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

    Screenshot: Verbundene Dienste im Menübereich ausgewählt. Das „+“-Symbol ist hervorgehoben.

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

    Screenshot der Seite „Abhängigkeit hinzufügen“. Azure Cache for Redis ist ausgewählt.

    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: Bildschirm „Azure Cache for Redis konfigurieren“. „Weiter“ ist hervorgehoben.

  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: Azure Cache for Redis neue Seite erstellen. Erstellen ist hervorgehoben.

    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: die Seite „Azure Cache for Redis-Verbindungsinformationen“. „Weiter“ ist hervorgehoben.

  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: die Seite „Zusammenfassung der Änderungen“. „Fertig stellen“ ist hervorgehoben.

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

    Screenshot: Liste der konfigurierten Dienstabhängigkeiten

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: Optionen des Kontextmenüs „Verbundene Dienste“

    Wenn der Knoten Verbundene Dienste nicht angezeigt wird, wählen Sie Projekt>Verbundene Dienste>Hinzufügen aus.

  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, der Auswahlmöglichkeiten für Azure Cache for Redis zeigt

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

    Screenshot, der Verbindungsoptionen für Azure Cache for Redis in einem lokalen Container zeigt.

    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 der Seite „Abhängigkeit hinzufügen“. Azure Cache for Redis ist ausgewählt.

    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: Bildschirm „Azure Cache for Redis konfigurieren“. „Weiter“ ist hervorgehoben.

  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: Azure Cache for Redis neue Seite erstellen. Erstellen ist hervorgehoben.

    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 Verbindungseinstellung ein, oder akzeptieren Sie den Standardwert.

    Screenshot: die Seite „Azure Cache for Redis-Verbindungsinformationen“. „Weiter“ ist hervorgehoben.

    Hinweis

    Um die Sicherheit zu verbessern, erstellt dieser Schritt in Visual Studio 17.12 und höher einen Verbindungseinstellungsnamen. In früheren Versionen wird ein Verbindungszeichenfolge erstellt. Verbindungszeichenfolgen, die im lokalen Dateisystem gespeichert sind, können zu einem Sicherheitsrisiko führen, wenn sie versehentlich verfügbar gemacht werden.

  8. Klicken Sie auf "Zusätzliche Einstellungen" , und wählen Sie aus, ob die Verbindungseinstellung in einer lokalen geheimen Datei oder in Azure Key Vault gespeichert werden soll.

    Screenshot der Seite

  9. 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: die Seite „Zusammenfassung der Änderungen“. „Fertig stellen“ ist hervorgehoben.

  10. 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: Liste der konfigurierten Dienstabhängigkeiten

    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.