Dodawanie usługi Azure Storage przy użyciu usług połączonych programu Visual Studio

Za pomocą programu Visual Studio możesz połączyć dowolny z następujących elementów z usługą Azure Storage przy użyciu funkcji usług połączonych:

• Aplikacja konsolowa .NET Framework
• Model-View-Controller (MVC) ASP.NET (.NET Framework)
• ASP.NET Core
• .NET Core (w tym aplikacja konsolowa, WPF, Windows Forms, biblioteka klas)
• Rola procesu roboczego platformy .NET Core
• Funkcje Azure
• Aplikacja platformy uniwersalnej systemu Windows
• Cordova

Funkcja połączonej usługi dodaje wszystkie wymagane odwołania i kod połączenia do projektu oraz odpowiednio modyfikuje pliki konfiguracji.

Warunki wstępne

• Program Visual Studio (zobacz [Pliki do pobrania programu Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) z zainstalowanym obciążeniem Azure development.
• Projekt jednego z obsługiwanych typów
• Konto platformy Azure. Jeśli nie masz konta Azure, aktywuj swoje korzyści Azure dla użytkowników Visual Studio lub zarejestruj się na bezpłatną wersję próbną.

Nawiązywanie połączenia z usługą Azure Storage przy użyciu połączonych usług

1. Otwórz projekt w programie Visual Studio.

2. Naciśnij Ctrl+Q (lub użyj przycisku wyszukiwania w środowisku IDE Visual Studio po prawej stronie paska menu głównego).

3. W wyszukiwanie funkcji, wprowadź Azure Storagei wybierz Azure Storage — Project > Connected Services > Dodaj > Azure Storage.

   

4. Na stronie Połącz z zależnością wybierz Azure Storage, a następnie wybierz Dalej.

   

   Jeśli jeszcze nie zalogowałeś się, zaloguj się do swojego konta platformy Azure. Jeśli nie masz konta na platformie Azure, możesz zarejestrować się na bezpłatną wersję próbną .

5. Na ekranie Połącz się z usługą Azure Storage wybierz istniejące konto magazynowe i wybierz Dalej.

   Jeśli musisz utworzyć konto magazynowe, przejdź do następnego kroku. W przeciwnym razie przejdź do następującego kroku.

   

6. Aby utworzyć konto magazynowe:

   1. Wybierz pozycję Utwórz nowy przy użyciu zielonego znaku plusa.

   2. Wypełnij okno dialogowe Azure Storage: Utwórz nowy i wybierz Utwórz.

      

   3. Po wyświetleniu okna dialogowego usługi Azure Storage nowe konto magazynu zostanie wyświetlone na liście. Wybierz nowe konto magazynu na liście, a następnie wybierz pozycję Dalej.

7. Wprowadź nazwę ustawienia parametrów połączenia. Nazwa ustawienia odwołuje się do nazwy ustawienia parametrów połączenia, które jest wyświetlane w pliku secrets.json lub w usłudze Azure Key Vault.

   

8. Określ, czy ciąg połączenia ma być przechowywany w lokalnym tajnym pliku, w usłudze Azure Key Vault, lub nie przechowywać ich wcale.

   

   Ostrożność

   Jeśli używasz wersji programu Visual Studio starszej niż Visual Studio 17.12 i zdecydujesz się użyć pliku secrets.json, musisz podjąć środki ostrożności, ponieważ parametry połączenia w lokalnym pliku secrets.json mogą zostać ujawnione. Jeśli używasz programu Visual Studio 2022 w wersji 17.12 lub nowszej, ta procedura generuje bardziej bezpieczny wynik, ponieważ daje wartość ustawienia połączenia, zamiast parametrów połączenia z poświadczeniami uwierzytelniania.

9. Na ekranie Podsumowanie zmian są wyświetlane wszystkie modyfikacje wprowadzone w projekcie w przypadku ukończenia procesu. Jeśli zmiany wyglądają w porządku, wybierz opcję Zakończ.

   

10. Usługa połączonego przechowywania jest wyświetlana w węźle Połączone Usługi projektu.

Omówienie uwierzytelniania

Po uruchomieniu poprzedniej procedury aplikacja jest skonfigurowana do używania uwierzytelniania w celu uzyskania dostępu do konta magazynu. Informacje o połączeniu dla tego uwierzytelniania są przechowywane lokalnie, jeśli wybrano metodę secrets.json lub w magazynie kluczy platformy Azure.

Jeśli użyłeś pliku secrets.json, otwórz plik, korzystając z trzech kropek obok Secrets.json na karcie Connected Services, aby otworzyć menu, a następnie wybierz Zarządzaj tajnymi danymi użytkownika. W programie Visual Studio 2022 w wersji 17.12 lub nowszej ten plik zawiera ustawienia odwołujące się do identyfikatora URI w celu uzyskania bezpiecznych parametrów połączenia, a nie samych parametrów połączenia.

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

W przypadku tych ustawień w programie Visual Studio 17.12 i nowszych uwierzytelnianie jest automatyczne i elastyczne. Podczas uruchamiania lub debugowania lokalnego z poziomu programu Visual Studio poświadczenia platformy Azure zapisane przez program Visual Studio są używane do uzyskiwania dostępu do konta usługi Azure Storage. Jeśli uruchomisz aplikację z poziomu wiersza polecenia, najpierw musisz zalogować się przy użyciu interfejsu wiersza polecenia platformy Azure, a te poświadczenia zostaną automatycznie wykryte i użyte. Jednak gdy aplikacja jest wdrażana na platformie Azure i działa na platformie Azure, używa tożsamości zarządzanej bez żadnych zmian w kodzie. Uwierzytelnianie działa we wszystkich środowiskach hostingowych, ponieważ interfejsy API Azure Identity sprawdzają wszystkie połączone poświadczenia w sekwencji i używają ich, gdy zostaną znalezione. Zobacz DefaultAzureCredential.

Następne kroki

Usługa Azure Storage obsługuje obiekty blob i kolejki, a także inne funkcje.

Aby dowiedzieć się więcej na temat pracy z obiektami blob, możesz skorzystać z Szybkiego Startu dotyczącego magazynu obiektów blob, ale zamiast rozpoczynać od początku, możesz zacząć od Szybkiego Startu dla obiektów blob platformy Azure (.NET) — przykłady kodu.

Aby dowiedzieć się więcej na temat pracy z kolejkami, zacznij od Szybki start usługi Azure Queue Storage (.NET): przykłady kodu.

Powiązana zawartość

• forum usługi Azure Storage
• Dokumentacja Azure Storage