Hinzufügen von Azure Storage mithilfe von Visual Studio Connected Services

Mit Visual Studio können Sie eine der folgenden Verbindungen mit Azure Storage 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-Worker
• Azure-Funktionen
• Universelle Windows-Plattform-App
• Xamarin
• Cordova

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

Voraussetzungen

• Visual Studio (siehe [Visual Studio-Downloads] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) mit der installierten Workload Azure-Entwicklung
• Ein Projekt eines der unterstützten Typen
• Ein Azure-Konto. Wenn Sie kein Azure-Konto haben, aktivieren Sie Ihre Azure-Vorteile für Visual Studio-Abonnenten oder melden Sie sich für eine kostenlose Testversion an.

Verbindung zu Azure Storage über verbundene Dienste herstellen

1. Öffnen Sie Ihr Projekt in Visual Studio.

2. Drücken Sie STRG+Q- (oder verwenden Sie die Schaltfläche Suchen in der Visual Studio-IDE rechts neben der Hauptmenüleiste).

3. Geben Sie Azure Storage in Featuresuche ein, und wählen Sie Azure Storage – Projekt > Verbundene Dienste > Hinzufügen > Azure Storage aus.

   

4. Wählen Sie auf der Seite Mit Abhängigkeit verbinden die Option Azure Storage und dann Weiter aus.

   

   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 Mit Azure Storage verbinden ein vorhandenes Speicherkonto und dann Weiter aus.

   Wenn Sie ein Speicherkonto erstellen müssen, fahren Sie mit dem nächsten Schritt fort. Überspringen Sie andernfalls diesen Schritt und fahren Sie mit dem nächsten fort.

   

6. So erstellen Sie ein Speicherkonto:

   1. Wählen Sie neben dem grünen Pluszeichen Neu erstellen aus.

   2. Füllen Sie das Dialogfeld Azure Storage: Neu erstellen und anschließend Erstellen aus.

      

   3. Wenn das Dialogfeld Azure Storage angezeigt wird, wird das neue Speicherkonto in der Liste angezeigt. Wählen Sie das neue Speicherkonto in der Liste aus, und wählen Sie Weiteraus.

7. Geben Sie einen Namen für die Verbindungszeichenfolge ein. Der Einstellungsname verweist auf den Namen der Verbindungszeichenfolgeneinstellung, wie sie in der datei secrets.json oder in Azure Key Vault angezeigt wird.

   

8. Wählen Sie aus, ob die Verbindungszeichenfolge in einer lokalen Schlüsseldatei, in Azure Key Vaultoder nirgendwo gespeichert werden soll.

   

   Vorsicht

   Wenn Sie eine Version von Visual Studio vor Visual Studio 17.12 verwenden und eine secrets.json-Datei verwenden möchten, müssen Sie Sicherheitsmaßnahmen ergreifen, da die Verbindungszeichenfolge in der lokalen secrets.json-Datei offengelegt werden könnte. Wenn Sie Visual Studio 2022, Version 17.12 oder höher, verwenden, erzeugt dieses Verfahren ein sichereres Ergebnis, da es einen Verbindungseinstellungswert anstelle einer Verbindungszeichenfolge mit Authentifizierungsanmeldeinformationen liefert.

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.

   

10. Der mit dem Speicher verbundene Dienst wird unter dem Knoten Connected Services Ihres Projekts angezeigt.

Grundlegendes zur Authentifizierung

Nachdem Sie das vorherige Verfahren ausgeführt haben, ist Ihre App so eingerichtet, dass die Authentifizierung für den Zugriff auf das Speicherkonto verwendet wird. Die Verbindungsinformationen für diese Authentifizierung werden lokal gespeichert, wenn Sie die secrets.json Methode oder in Ihrem Azure Key Vault ausgewählt haben.

Wenn Sie die secrets.json Datei verwendet haben, öffnen Sie die Datei mithilfe der drei Punkte neben Secrets.json auf der Registerkarte Verbundene Dienste, um ein Menü zu öffnen, und wählen Sie Verwalten von geheimen Benutzerschlüsselnaus. Mit Visual Studio 2022, Version 17.12 und höher, enthält diese Datei Einstellungen, die auf einen URI verweisen, um die sichere Verbindungszeichenfolge anstelle der Verbindungszeichenfolge selbst abzurufen.

{
  "StorageConnection:blobServiceUri": "https://webapplication16storagex.blob.core.windows.net/",
  "StorageConnection:queueServiceUri": "https://webapplication16storagex.queue.core.windows.net/",
  "StorageConnection:tableServiceUri": "https://webapplication16storagex.table.core.windows.net/"
}

Mit diesen Einstellungen in Visual Studio 17.12 und höher ist die Authentifizierung automatisch und flexibel. Wenn Sie lokal in Visual Studio ausführen oder debuggen, werden Ihre von Visual Studio gespeicherten Azure-Anmeldeinformationen für den Zugriff auf das Azure Storage-Konto verwendet. Wenn Sie Ihre App über die Befehlszeile starten, müssen Sie sich zuerst mit der Azure CLI anmelden, und diese Anmeldeinformationen werden automatisch erkannt und verwendet. Wenn Ihre App jedoch in Azure bereitgestellt und in Azure ausgeführt wird, verwendet sie verwaltete Identität, ohne Dass sich Code ändert. Die Authentifizierung funktioniert in allen Hostingumgebungen, da die Azure Identity-APIs nach allen verketteten Anmeldeinformationen in Sequenz suchen und sie verwenden, wenn sie gefunden werden. Weitere Informationen finden Sie unter DefaultAzureCredential.

Nächste Schritte

Azure Storage unterstützt Blobs und Warteschlangen sowie andere Features.

Wenn Sie mehr über das Arbeiten mit Blobs erfahren möchten, können Sie mit der Schnellstartanleitung für blob-Speicher fortfahren, aber anstatt am Anfang zu beginnen, können Sie mit Azure Blobs Schnellstart (.NET) beginnen – Codebeispiele.

Um mehr über das Arbeiten mit Warteschlangen zu erfahren, beginnen Sie bei Azure Queue Storage Quickstart (.NET) – Codebeispiele.

Verwandte Inhalte

• Azure Storage-Forum
• Azure Storage-Dokumentation