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

Za pomocą programu Visual Studio można połączyć dowolne z następujących elementów z usługą Azure Storage przy użyciu funkcji Usługi połączone:

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

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

Wymagania wstępne

• Program Visual Studio (zobacz [Pliki do pobrania programu Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) z zainstalowanym pakietem roboczym Programowanie na platformie Azure.
• Projekt jednego z obsługiwanych typów
• Konto Azure. Jeśli nie masz konta platformy Azure, aktywuj korzyści platformy Azure dla subskrybentów programu Visual Studio lub zarejestruj się w celu uzyskania bezpłatnej wersji próbnej.

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 Wyszukaj w środowisku IDE programu Visual Studio po prawej stronie paska menu głównego).

3. W obszarze Wyszukiwanie funkcji wprowadź ciąg Azure Storage, a następnie wybierz pozycję Azure Storage — Usługi połączone > z projektem > Dodaj > usługę Azure Storage.

   

4. Na stronie Łączenie z zależnością wybierz pozycję Azure Storage, a następnie wybierz pozycję Dalej.

   

   Jeśli jeszcze nie zalogowałeś się, zaloguj się do swojego konta platformy Azure. Jeśli nie masz konta platformy Azure, możesz skorzystać z bezpłatnej wersji próbnej.

5. Na ekranie Łączenie z usługą Azure Storage wybierz istniejące konto magazynu, a następnie wybierz pozycję Dalej.

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

   

6. Aby utworzyć konto magazynu:

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

   2. Wypełnij pole Azure Storage: Utwórz nowe okno dialogowe i wybierz pozycję 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 parametry połączenia. Nazwa ustawienia odwołuje się do nazwy ustawienia parametry połączenia wyświetlanego w pliku secrets.json lub w usłudze Azure Key Vault.

   

8. Określ, czy chcesz, aby parametry połączenia przechowywany w lokalnym pliku wpisów tajnych, w usłudze Azure Key Vault, czy nie był przechowywany w żadnym miejscu.

   

   Uwaga

   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 może zostać ujawniony. 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, a nie parametry połączenia z poświadczeniami uwierzytelniania.

9. Na ekranie Podsumowanie zmian zostaną wyświetlone wszystkie modyfikacje wprowadzone w projekcie w przypadku ukończenia procesu. Jeśli zmiany wyglądają ok, wybierz przycisk Zakończ.

   

10. Połączona usługa magazynu jest wyświetlana w węźle Usługi połączone w projekcie.

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 usłudze Azure Key Vault.

Jeśli użyto pliku secrets.json , otwórz plik przy użyciu trzech kropek obok Secrets.json na karcie Usługi połączone, aby otworzyć menu, a następnie wybierz pozycję Zarządzaj wpisami tajnymi 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 bezpiecznego parametry połączenia, a nie samego parametry 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 hostingu, ponieważ interfejsy API tożsamości platformy Azure sprawdzają wszystkie poświadczenia łańcuchowe w sekwencji i używają ich po znalezieniu. Zobacz Wartość domyślnaAzureCredential.

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 kontynuować pracę z przewodnikiem Szybki start dotyczącym usługi Blob Storage, ale zamiast rozpoczynać od początku, możesz rozpocząć pracę z przewodnikiem Szybki start dla obiektów blob platformy Azure (.NET) — przykłady kodu.

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

Powiązana zawartość

• Forum usługi Azure Storage
• Dokumentacja usługi Azure Storage