Freigeben über


Hinzufügen des Azure-Caches für Redis mithilfe von Visual Studio Connected Services

Mit Visual Studio können Sie eine der folgenden Verbindungen mit dem Azure-Cache für Redis herstellen, indem Sie das Feature Connected Services verwenden:

  • .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
  • Universelle Windows-Plattform-App
  • Cordova

Die funktion des verbundenen Diensts fügt dem Projekt alle erforderlichen Verweise und Verbindungscode hinzu und ändert die Konfigurationsdateien entsprechend.

Voraussetzungen

Herstellen einer Verbindung mit Azure Cache für Redis mithilfe von verbundenen Diensten

Anmerkung

Bei .NET Framework-Projekten unterscheidet sich die Benutzeroberfläche für verbundene Dienste geringfügig. Um die Unterschiede zu ermitteln, vergleichen Sie sie mit der Visual Studio 2019-Version auf dieser Seite.

  1. Öffnen Sie Ihr Projekt in Visual Studio.

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

    Screenshot mit den Kontextmenüoptionen für 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 für Redisaus. Die Seite Mit Abhängigkeit verbinden wird angezeigt. Es sollten zwei Optionen angezeigt werden, eine für einen lokalen Emulator, Redis Cache für Container (lokal)und eine für die Verbindung mit dem Live-Azure-Cache für Redis-Dienst. Sie können Kosten reduzieren 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 mit Azure Cache für Redis-Auswahlmöglichkeiten

    Wenn Sie die Azure Cache for Redis-Instanz lokal auswählen, klicken Sie auf Weiter, um zum Bildschirm Verbindung mit Redis Cache-Instanz für Container herstellen zu gelangen.

    Screenshot mit Verbindungsoptionen für Azure Cache für Redis in einem lokalen Container.

    Geben Sie Containernamen, Containerimageund Portzuordnungen an, oder übernehmen Sie die Standardeinstellungen, und klicken Sie auf Nächsten, um die Zusammenfassung der Änderungen Bildschirm anzuzeigen, in der angezeigt wird, welche Änderungen an Ihrem Projekt vorgenommen werden. Ihrem Projekt wird ein NuGet-Paketverweis hinzugefügt, und dem Projekt wird 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 wenn Sie noch nicht angemeldet sind, melden Sie sich bei Ihrem Azure-Konto an, bevor Sie fortfahren. Wenn Sie nicht über ein Azure-Konto verfügen, können Sie sich für eine kostenlose Testversionregistrieren.

  4. Um mit dem Livedienst zu wechseln, wählen Sie Azure-Cache für Redisaus.

    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 eine vorhandene Azure Cache for Redis-Instanz aus, und klicken Sie auf Weiter.

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

    Screenshot des Bildschirms

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

    1. Wählen Sie unten auf dem Bildschirm Neue Azure Redis Cache-Instanz erstellen aus.

    2. Füllen Sie den Bildschirm Azure Cache for Redis: Neu erstellen aus, und klicken Sie auf Erstellen.

      Screenshot des Azure-Caches für Redis zum Erstellen einer neuen Seite.

    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 aus, und wählen Sie Weiteraus.

  7. Geben Sie einen Namen für die Verbindungseinstellung ein, oder akzeptieren Sie den Standardwert.

    Screenshot der Verbindungsinformationsseite von Azure Cache for Redis. Die Schaltfläche „Weiter“ ist hervorgehoben.

    Anmerkung

    Um die Sicherheit zu verbessern, erstellt dieser Schritt in Visual Studio 17.12 und höher einen Verbindungseinstellungsnamen. In früheren Versionen wird eine 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 Vaultgespeichert werden soll.

    Screenshot der Seite

  9. Die Zusammenfassung der Änderungen Bildschirm zeigt alle Änderungen an, die an Ihrem Projekt vorgenommen werden, wenn Sie den Vorgang abgeschlossen haben. Wenn die Änderungen korrekt sind, wählen Sie Fertig stellen aus.

    Screenshot der Seite „Zusammenfassung der Änderungen“. „Fertig“ ist hervorgehoben.

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

    Screenshot mit einer Liste der konfigurierten Dienstabhängigkeiten.

    Wenn Sie neben der hinzugefügten Abhängigkeit auf die drei Punkte klicken, werden verschiedene Optionen wie Connect angezeigt, 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 anzuzeigen, um lokale Abhängigkeiten zu starten, Einstellungen zu ändern und vieles mehr.

Nächste Schritte

Bei ASP.NET Apps sind häufige Anwendungsfälle für Azure Cache für Redis das Zwischenspeichern des Sitzungszustands oder der Seitenausgabe (HTTP-Antworten). 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 Sitzungsstatusanbieter.

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