Szybki start: biblioteka klienta usługi Azure Blob Storage dla platformy .NET
Uwaga
Opcja Kompiluj od podstaw przeprowadzi Cię krok po kroku przez proces tworzenia nowego projektu, instalowania pakietów, pisania kodu i uruchamiania podstawowej aplikacji konsolowej. To podejście jest zalecane, jeśli chcesz zrozumieć wszystkie szczegóły związane z tworzeniem aplikacji łączącej się z usługą Azure Blob Storage. Jeśli wolisz zautomatyzować zadania wdrażania i rozpocząć od ukończonego projektu, wybierz pozycję Rozpocznij od szablonu.
Uwaga
Opcja Rozpocznij od szablonu używa interfejsu wiersza polecenia dla deweloperów platformy Azure do automatyzowania zadań wdrażania i rozpoczyna się od ukończonego projektu. To podejście jest zalecane, jeśli chcesz eksplorować kod tak szybko, jak to możliwe bez przechodzenia przez zadania konfiguracji. Jeśli wolisz instrukcje krok po kroku dotyczące kompilowania aplikacji, wybierz pozycję Kompiluj od podstaw.
Rozpocznij pracę z biblioteką klienta usługi Azure Blob Storage dla platformy .NET. Usługa Azure Blob Storage to rozwiązanie magazynu obiektów firmy Microsoft dla chmury i zoptymalizowane pod kątem przechowywania ogromnych ilości danych bez struktury.
W tym artykule wykonasz kroki, aby zainstalować pakiet i wypróbować przykładowy kod dla podstawowych zadań.
W tym artykule użyjesz interfejsu wiersza polecenia dla deweloperów platformy Azure, aby wdrożyć zasoby platformy Azure i uruchomić ukończoną aplikację konsolową z zaledwie kilkoma poleceniami.
Dokumentacja interfejsu API — przykłady | pakietu kodu | źródłowego biblioteki (NuGet) |
W tym filmie wideo pokazano, jak rozpocząć korzystanie z biblioteki klienta usługi Azure Blob Storage dla platformy .NET.
Kroki opisane w filmie wideo zostały również opisane w poniższych sekcjach.
Wymagania wstępne
- Subskrypcja platformy Azure — utwórz jedną bezpłatnie
- Konto usługi Azure Storage — tworzenie konta magazynu
- Najnowszy zestaw .NET SDK dla systemu operacyjnego. Pamiętaj, aby pobrać zestaw SDK, a nie środowisko uruchomieniowe.
- Subskrypcja platformy Azure — utwórz jedną bezpłatnie
- Najnowszy zestaw .NET SDK dla systemu operacyjnego. Ten przykładowy kod używa platformy .NET 8.0. Pamiętaj, aby pobrać zestaw SDK, a nie środowisko uruchomieniowe.
- Interfejs wiersza polecenia dla deweloperów platformy Azure
Konfigurowanie
Ta sekcja przeprowadzi Cię przez proces przygotowywania projektu do pracy z biblioteką klienta usługi Azure Blob Storage dla platformy .NET.
Tworzenie projektu
Utwórz aplikację konsolową platformy .NET przy użyciu interfejsu wiersza polecenia platformy .NET lub programu Visual Studio 2022.
W górnej części programu Visual Studio przejdź do pozycji Plik>nowy>projekt...
W oknie dialogowym wprowadź ciąg aplikacja konsolowa w polu wyszukiwania szablonu projektu i wybierz pierwszy wynik. Wybierz pozycję Dalej w dolnej części okna dialogowego.
W polu Nazwa projektu wprowadź blobQuickstart. Pozostaw wartości domyślne pozostałych pól i wybierz pozycję Dalej.
W przypadku programu Framework upewnij się, że wybrano najnowszą zainstalowaną wersję platformy .NET. Następnie wybierz pozycję Utwórz. Nowy projekt zostanie otwarty w środowisku programu Visual Studio.
Instalowanie pakietu
Aby korzystać z usługi Azure Blob Storage, zainstaluj bibliotekę klienta usługi Azure Blob Storage dla platformy .NET.
W Eksplorator rozwiązań kliknij prawym przyciskiem myszy węzeł Zależności projektu. Wybierz pozycję Zarządzaj pakietami NuGet.
W wyświetlonym oknie wyszukaj ciąg Azure.Storage.Blobs. Wybierz odpowiedni wynik, a następnie wybierz pozycję Zainstaluj.
Konfigurowanie kodu aplikacji
Zastąp kod początkowy w Program.cs
pliku, tak aby był zgodny z poniższym przykładem, który zawiera instrukcje niezbędne using
do tego ćwiczenia.
using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;
using System;
using System.IO;
// See https://aka.ms/new-console-template for more information
Console.WriteLine("Hello, World!");
Po zainstalowaniu interfejsu wiersza polecenia dla deweloperów platformy Azure możesz utworzyć konto magazynu i uruchomić przykładowy kod za pomocą kilku poleceń. Projekt można uruchomić w lokalnym środowisku deweloperskim lub w usłudze DevContainer.
Inicjowanie szablonu interfejsu wiersza polecenia dewelopera platformy Azure i wdrażanie zasobów
W pustym katalogu wykonaj następujące kroki, aby zainicjować azd
szablon, aprowizować zasoby platformy Azure i rozpocząć pracę z kodem:
Sklonuj zasoby repozytorium szybkiego startu z usługi GitHub i zainicjuj szablon lokalnie:
azd init --template blob-storage-quickstart-dotnet
Zostanie wyświetlony monit o podanie następujących informacji:
- Nazwa środowiska: ta wartość jest używana jako prefiks dla wszystkich zasobów platformy Azure utworzonych przez interfejs wiersza polecenia dewelopera platformy Azure. Nazwa musi być unikatowa we wszystkich subskrypcjach platformy Azure i musi mieć długość od 3 do 24 znaków. Nazwa może zawierać tylko cyfry i małe litery.
Zaloguj się do platformy Azure:
azd auth login
Aprowizuj i wdróż zasoby na platformie Azure:
azd up
Zostanie wyświetlony monit o podanie następujących informacji:
- Subskrypcja: subskrypcja platformy Azure, w ramach którego są wdrażane zasoby.
- Lokalizacja: region świadczenia usługi Azure, w którym są wdrażane zasoby.
Ukończenie wdrożenia może potrwać kilka minut. Dane wyjściowe polecenia
azd up
zawierają nazwę nowo utworzonego konta magazynu, które będzie potrzebne później do uruchomienia kodu.
Uruchamianie przykładowego kodu
W tym momencie zasoby są wdrażane na platformie Azure, a projekt jest gotowy do uruchomienia. Wykonaj następujące kroki, aby zaktualizować nazwę konta magazynu w kodzie i uruchomić przykładową aplikację konsolową:
- Zaktualizuj nazwę konta magazynu: przejdź do katalogu i zmodyfikuj
src
Program.cs
plik .<storage-account-name>
Znajdź symbol zastępczy i zastąp go rzeczywistą nazwą konta magazynu utworzonegoazd up
przez polecenie . Zapisz zmiany. - Uruchom projekt: jeśli używasz programu Visual Studio, naciśnij F5, aby skompilować i uruchomić kod oraz wchodzić w interakcje z aplikacją konsolową. Jeśli używasz interfejsu wiersza polecenia platformy .NET, przejdź do katalogu aplikacji, skompiluj projekt przy użyciu polecenia
dotnet build
i uruchom aplikację przy użyciu poleceniadotnet run
. - Obserwuj dane wyjściowe: Ta aplikacja tworzy plik testowy w lokalnym folderze danych i przekazuje go do kontenera na koncie magazynu. W tym przykładzie wymieniono obiekty blob w kontenerze i pobraliśmy plik z nową nazwą, aby można było porównać stare i nowe pliki.
Aby dowiedzieć się więcej o sposobie działania przykładowego kodu, zobacz Przykłady kodu.
Po zakończeniu testowania kodu zobacz sekcję Czyszczenie zasobów , aby usunąć zasoby utworzone za azd up
pomocą polecenia .
Model obiektów
Usługa Azure Blob Storage jest zoptymalizowana pod kątem przechowywania ogromnych ilości danych bez struktury. Dane bez struktury nie są zgodne z określonym modelem lub definicją danych, takimi jak dane tekstowe lub binarne. Magazyn obiektów blob oferuje trzy typy zasobów:
- Konto magazynu
- Kontener na koncie magazynu
- Obiekt blob w kontenerze
Na poniższym diagramie przedstawiono relacje między tymi zasobami.
Użyj następujących klas platformy .NET, aby wchodzić w interakcje z tymi zasobami:
- BlobServiceClient:
BlobServiceClient
klasa umożliwia manipulowanie zasobami usługi Azure Storage i kontenerami obiektów blob. - BlobContainerClient:
BlobContainerClient
klasa umożliwia manipulowanie kontenerami usługi Azure Storage i ich obiektami blob. - BlobClient:
BlobClient
klasa umożliwia manipulowanie obiektami blob usługi Azure Storage.
Przykłady kodu
Przykładowe fragmenty kodu w poniższych sekcjach przedstawiają sposób wykonywania następujących zadań za pomocą biblioteki klienta usługi Azure Blob Storage dla platformy .NET:
- Uwierzytelnianie na platformie Azure i autoryzacja dostępu do danych obiektów blob
- Tworzenie kontenera
- Przekazywanie obiektu blob do kontenera
- Wyświetlanie listy obiektów blob w kontenerze
- Pobieranie obiektu blob
- Usuwanie kontenera
Ważne
Upewnij się, że zainstalowano poprawne pakiety NuGet i dodano niezbędne instrukcje using, aby przykłady kodu działały zgodnie z opisem w sekcji konfigurowania .
Uwaga
Szablon interfejsu wiersza polecenia dla deweloperów platformy Azure zawiera projekt z przykładowym kodem już w miejscu. Poniższe przykłady zawierają szczegółowe informacje dotyczące każdej części przykładowego kodu. Szablon implementuje zalecaną metodę uwierzytelniania bez hasła zgodnie z opisem w sekcji Uwierzytelnianie na platformie Azure . Metoda parametry połączenia jest wyświetlana jako alternatywa, ale nie jest używana w szablonie i nie jest zalecana dla kodu produkcyjnego.
Uwierzytelnianie na platformie Azure i autoryzacja dostępu do danych obiektów blob
Żądania aplikacji do usługi Azure Blob Storage muszą być autoryzowane. DefaultAzureCredential
Użycie klasy udostępnionej przez bibliotekę klienta tożsamości platformy Azure jest zalecanym podejściem do implementowania połączeń bez hasła z usługami platformy Azure w kodzie, w tym usługi Blob Storage.
Możesz również autoryzować żądania do usługi Azure Blob Storage przy użyciu klucza dostępu do konta. Należy jednak zachować ostrożność przy użyciu tego podejścia. Deweloperzy muszą być sumienni, aby nigdy nie ujawniać klucza dostępu w niezabezpieczonej lokalizacji. Każdy, kto ma klucz dostępu, może autoryzować żądania względem konta magazynu i efektywnie ma dostęp do wszystkich danych. DefaultAzureCredential
oferuje ulepszone korzyści związane z zarządzaniem i zabezpieczeniami za pośrednictwem klucza konta, aby umożliwić uwierzytelnianie bez hasła. Obie opcje przedstawiono w poniższym przykładzie.
DefaultAzureCredential
jest klasą dostarczaną przez bibliotekę klienta tożsamości platformy Azure dla platformy .NET, którą można dowiedzieć się więcej na temat przeglądu DefaultAzureCredential. DefaultAzureCredential
obsługuje wiele metod uwierzytelniania i określa, która metoda powinna być używana w czasie wykonywania. Takie podejście umożliwia aplikacji używanie różnych metod uwierzytelniania w różnych środowiskach (lokalnych i produkcyjnych) bez implementowania kodu specyficznego dla środowiska.
Kolejność i lokalizacje, w których DefaultAzureCredential
można znaleźć poświadczenia, można znaleźć w przeglądzie biblioteki tożsamości platformy Azure.
Na przykład aplikacja może uwierzytelniać się przy użyciu poświadczeń logowania programu Visual Studio przy użyciu polecenia podczas opracowywania lokalnego. Aplikacja może następnie użyć tożsamości zarządzanej po jej wdrożeniu na platformie Azure. Do tego przejścia nie są wymagane żadne zmiany kodu.
Przypisywanie ról do konta użytkownika usługi Microsoft Entra
Podczas tworzenia aplikacji lokalnie upewnij się, że konto użytkownika, które uzyskuje dostęp do danych obiektów blob, ma odpowiednie uprawnienia. Będziesz potrzebować współautora danych obiektu blob usługi Storage, aby odczytywać i zapisywać dane obiektów blob. Aby przypisać sobie tę rolę, musisz mieć przypisaną rolę Administratora dostępu użytkowników lub inną rolę obejmującą akcję Microsoft.Authorization/roleAssignments/write . Role RBAC platformy Azure można przypisać użytkownikowi przy użyciu witryny Azure Portal, interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell. Więcej informacji na temat dostępnych zakresów przypisań ról można znaleźć na stronie przeglądu zakresu.
W tym scenariuszu przypiszesz uprawnienia do konta użytkownika w zakresie konta magazynu, aby postępować zgodnie z zasadą najniższych uprawnień. Ta praktyka zapewnia użytkownikom tylko minimalne wymagane uprawnienia i tworzy bezpieczniejsze środowiska produkcyjne.
W poniższym przykładzie do konta użytkownika zostanie przypisana rola Współautor danych obiektu blob usługi Storage, która zapewnia zarówno dostęp do odczytu, jak i zapisu do danych obiektów blob na koncie magazynu.
Ważne
W większości przypadków propagacja przypisania roli na platformie Azure potrwa minutę lub dwie, ale w rzadkich przypadkach może upłynąć do ośmiu minut. Jeśli podczas pierwszego uruchomienia kodu wystąpią błędy uwierzytelniania, zaczekaj chwilę i spróbuj ponownie.
W witrynie Azure Portal znajdź konto magazynu przy użyciu głównego paska wyszukiwania lub nawigacji po lewej stronie.
Na stronie przeglądu konta magazynu wybierz pozycję Kontrola dostępu (Zarządzanie dostępem i tożsamościami) z menu po lewej stronie.
Na stronie Kontrola dostępu (Zarządzanie dostępem i tożsamościami) wybierz kartę Przypisania ról.
Wybierz pozycję + Dodaj z górnego menu, a następnie pozycję Dodaj przypisanie roli z wyświetlonego menu rozwijanego.
Użyj pola wyszukiwania, aby filtrować wyniki do żądanej roli. W tym przykładzie wyszukaj pozycję Współautor danych obiektu blob usługi Storage i wybierz pasujący wynik, a następnie wybierz pozycję Dalej.
W obszarze Przypisz dostęp do wybierz pozycję Użytkownik, grupa lub jednostka usługi, a następnie wybierz pozycję + Wybierz członków.
W oknie dialogowym wyszukaj nazwę użytkownika firmy Microsoft Entra (zazwyczaj adres e-mail user@domain ), a następnie wybierz pozycję Wybierz w dolnej części okna dialogowego.
Wybierz pozycję Przejrzyj i przypisz , aby przejść do ostatniej strony, a następnie ponownie przejrzyj i przypisz, aby ukończyć proces.
Zaloguj się i połącz kod aplikacji z platformą Azure przy użyciu opcji DefaultAzureCredential
Dostęp do danych na koncie magazynu można autoryzować, wykonując następujące czynności:
-
W przypadku programowania lokalnego upewnij się, że uwierzytelniasz się przy użyciu tego samego konta Microsoft Entra, do którego przypisano rolę. Możesz uwierzytelnić się za pomocą popularnych narzędzi programistycznych, takich jak interfejs wiersza polecenia platformy Azure lub program Azure PowerShell. Narzędzia programistyczne, za pomocą których można uwierzytelniać się w różnych językach.
- Interfejs wiersza polecenia platformy Azure
- Program Visual Studio
- Visual Studio Code
- Program PowerShell
Zaloguj się do platformy Azure za pomocą interfejsu wiersza polecenia platformy Azure przy użyciu następującego polecenia:
az login
-
Aby użyć
DefaultAzureCredential
polecenia , dodaj pakiet Azure.Identity do aplikacji.W Eksplorator rozwiązań kliknij prawym przyciskiem myszy węzeł Zależności projektu. Wybierz pozycję Zarządzaj pakietami NuGet.
W wyświetlonym oknie wyszukaj ciąg Azure.Identity. Wybierz odpowiedni wynik, a następnie wybierz pozycję Zainstaluj.
Zaktualizuj kod Program.cs, aby był zgodny z poniższym przykładem. Gdy kod jest uruchamiany na lokalnej stacji roboczej podczas programowania, użyje poświadczeń dewelopera priorytetowego narzędzia, do którego logujesz się w celu uwierzytelnienia na platformie Azure, takiego jak interfejs wiersza polecenia platformy Azure lub program Visual Studio.
using Azure.Storage.Blobs; using Azure.Storage.Blobs.Models; using System; using System.IO; using Azure.Identity; // TODO: Replace <storage-account-name> with your actual storage account name var blobServiceClient = new BlobServiceClient( new Uri("https://<storage-account-name>.blob.core.windows.net"), new DefaultAzureCredential());
Pamiętaj, aby zaktualizować nazwę konta magazynu w identyfikatorze URI elementu
BlobServiceClient
. Nazwę konta magazynu można znaleźć na stronie przeglądu witryny Azure Portal.Uwaga
Po wdrożeniu na platformie Azure ten sam kod może służyć do autoryzowania żądań do usługi Azure Storage z aplikacji działającej na platformie Azure. Należy jednak włączyć tożsamość zarządzaną w aplikacji na platformie Azure. Następnie skonfiguruj konto magazynu, aby umożliwić nawiązywanie połączenia z tożsamością zarządzaną. Aby uzyskać szczegółowe instrukcje dotyczące konfigurowania tego połączenia między usługami platformy Azure, zobacz samouczek Auth from Azure-hosted apps (Uwierzytelnianie z poziomu aplikacji hostowanych na platformie Azure).
Tworzenie kontenera
Utwórz nowy kontener na koncie magazynu, wywołując metodę CreateBlobContainerAsync w blobServiceClient
obiekcie . W tym przykładzie kod dołącza wartość identyfikatora GUID do nazwy kontenera, aby upewnić się, że jest on unikatowy.
Na końcu pliku Program.cs
dodaj następujący kod:
// TODO: Replace <storage-account-name> with your actual storage account name
var blobServiceClient = new BlobServiceClient(
new Uri("https://<storage-account-name>.blob.core.windows.net"),
new DefaultAzureCredential());
//Create a unique name for the container
string containerName = "quickstartblobs" + Guid.NewGuid().ToString();
// Create the container and return a container client object
BlobContainerClient containerClient = await blobServiceClient.CreateBlobContainerAsync(containerName);
Aby dowiedzieć się więcej o tworzeniu kontenera i eksplorować więcej przykładów kodu, zobacz Tworzenie kontenera obiektów blob za pomocą platformy .NET.
Ważne
Nazwy kontenerów muszą być zapisane małymi literami. Aby uzyskać więcej informacji o nazewnictwie kontenerów i obiektów blob, zobacz temat Nazewnictwo i odwoływanie się do kontenerów, obiektów blob i metadanych.
Przekazywanie obiektu blob do kontenera
Przekaż obiekt blob do kontenera przy użyciu narzędzia UploadAsync. Przykładowy kod tworzy plik tekstowy w lokalnym katalogu danych w celu przekazania do kontenera.
Na końcu pliku Program.cs
dodaj następujący kod:
// Create a local file in the ./data/ directory for uploading and downloading
string localPath = "data";
Directory.CreateDirectory(localPath);
string fileName = "quickstart" + Guid.NewGuid().ToString() + ".txt";
string localFilePath = Path.Combine(localPath, fileName);
// Write text to the file
await File.WriteAllTextAsync(localFilePath, "Hello, World!");
// Get a reference to a blob
BlobClient blobClient = containerClient.GetBlobClient(fileName);
Console.WriteLine("Uploading to Blob storage as blob:\n\t {0}\n", blobClient.Uri);
// Upload data from the local file, overwrite the blob if it already exists
await blobClient.UploadAsync(localFilePath, true);
Aby dowiedzieć się więcej na temat przekazywania obiektów blob i eksplorowania dodatkowych przykładów kodu, zobacz Przekazywanie obiektu blob przy użyciu platformy .NET.
Wyświetlanie listy obiektów blob w kontenerze
Wyświetl listę obiektów blob w kontenerze, wywołując metodę GetBlobsAsync .
Na końcu pliku Program.cs
dodaj następujący kod:
Console.WriteLine("Listing blobs...");
// List all blobs in the container
await foreach (BlobItem blobItem in containerClient.GetBlobsAsync())
{
Console.WriteLine("\t" + blobItem.Name);
}
Aby dowiedzieć się więcej na temat wyświetlania listy obiektów blob i eksplorowania większej liczby przykładów kodu, zobacz Wyświetlanie listy obiektów blob za pomocą platformy .NET.
Pobieranie obiektu blob
Pobierz utworzony wcześniej obiekt blob, wywołując metodę DownloadToAsync . Przykładowy kod dołącza ciąg "DOWNLOADED" do nazwy pliku, aby zobaczyć oba pliki w lokalnym systemie plików.
Na końcu pliku Program.cs
dodaj następujący kod:
// Download the blob to a local file
// Append the string "DOWNLOADED" before the .txt extension
// so you can compare the files in the data directory
string downloadFilePath = localFilePath.Replace(".txt", "DOWNLOADED.txt");
Console.WriteLine("\nDownloading blob to\n\t{0}\n", downloadFilePath);
// Download the blob's contents and save it to a file
await blobClient.DownloadToAsync(downloadFilePath);
Aby dowiedzieć się więcej na temat pobierania obiektów blob i eksplorowania dodatkowych przykładów kodu, zobacz Pobieranie obiektu blob za pomocą platformy .NET.
Usuwanie kontenera
Poniższy kod czyści zasoby utworzone przez aplikację przez usunięcie kontenera przy użyciu narzędzia DeleteAsync. Przykładowy kod usuwa również pliki lokalne utworzone przez aplikację.
Aplikacja wstrzymuje dane wejściowe użytkownika przez wywołanie Console.ReadLine
metody przed usunięciem obiektu blob, kontenera i plików lokalnych. Jest to duża szansa na sprawdzenie, czy zasoby zostały utworzone poprawnie, zanim zostaną usunięte.
Na końcu pliku Program.cs
dodaj następujący kod:
// Clean up
Console.Write("Press any key to begin clean up");
Console.ReadLine();
Console.WriteLine("Deleting blob container...");
await containerClient.DeleteAsync();
Console.WriteLine("Deleting the local source and downloaded files...");
File.Delete(localFilePath);
File.Delete(downloadFilePath);
Console.WriteLine("Done");
Aby dowiedzieć się więcej o usuwaniu kontenera i poznać więcej przykładów kodu, zobacz Usuwanie i przywracanie kontenera obiektów blob za pomocą platformy .NET.
Ukończony kod
Po wykonaniu tych kroków kod w Program.cs
pliku powinien teraz wyglądać podobnie do następującego:
using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;
using Azure.Identity;
// TODO: Replace <storage-account-name> with your actual storage account name
var blobServiceClient = new BlobServiceClient(
new Uri("https://<storage-account-name>.blob.core.windows.net"),
new DefaultAzureCredential());
//Create a unique name for the container
string containerName = "quickstartblobs" + Guid.NewGuid().ToString();
// Create the container and return a container client object
BlobContainerClient containerClient = await blobServiceClient.CreateBlobContainerAsync(containerName);
// Create a local file in the ./data/ directory for uploading and downloading
string localPath = "data";
Directory.CreateDirectory(localPath);
string fileName = "quickstart" + Guid.NewGuid().ToString() + ".txt";
string localFilePath = Path.Combine(localPath, fileName);
// Write text to the file
await File.WriteAllTextAsync(localFilePath, "Hello, World!");
// Get a reference to a blob
BlobClient blobClient = containerClient.GetBlobClient(fileName);
Console.WriteLine("Uploading to Blob storage as blob:\n\t {0}\n", blobClient.Uri);
// Upload data from the local file
await blobClient.UploadAsync(localFilePath, true);
Console.WriteLine("Listing blobs...");
// List all blobs in the container
await foreach (BlobItem blobItem in containerClient.GetBlobsAsync())
{
Console.WriteLine("\t" + blobItem.Name);
}
// Download the blob to a local file
// Append the string "DOWNLOADED" before the .txt extension
// so you can compare the files in the data directory
string downloadFilePath = localFilePath.Replace(".txt", "DOWNLOADED.txt");
Console.WriteLine("\nDownloading blob to\n\t{0}\n", downloadFilePath);
// Download the blob's contents and save it to a file
await blobClient.DownloadToAsync(downloadFilePath);
// Clean up
Console.Write("Press any key to begin clean up");
Console.ReadLine();
Console.WriteLine("Deleting blob container...");
await containerClient.DeleteAsync();
Console.WriteLine("Deleting the local source and downloaded files...");
File.Delete(localFilePath);
File.Delete(downloadFilePath);
Console.WriteLine("Done");
Uruchamianie kodu
Ta aplikacja tworzy plik testowy w lokalnym folderze danych i przekazuje go do usługi Blob Storage. W tym przykładzie wymieniono obiekty blob w kontenerze i pobraliśmy plik z nową nazwą, aby można było porównać stare i nowe pliki.
Jeśli używasz programu Visual Studio, naciśnij F5, aby skompilować i uruchomić kod oraz wchodzić w interakcję z aplikacją konsolową. Jeśli używasz interfejsu wiersza polecenia platformy .NET, przejdź do katalogu aplikacji, a następnie skompiluj i uruchom aplikację.
dotnet build
dotnet run
Dane wyjściowe aplikacji są podobne do poniższego przykładu (pominięte wartości identyfikatora GUID w celu zapewnienia czytelności):
Azure Blob Storage - .NET quickstart sample
Uploading to Blob storage as blob:
https://mystorageacct.blob.core.windows.net/quickstartblobsGUID/quickstartGUID.txt
Listing blobs...
quickstartGUID.txt
Downloading blob to
./data/quickstartGUIDDOWNLOADED.txt
Press any key to begin clean up
Deleting blob container...
Deleting the local source and downloaded files...
Done
Przed rozpoczęciem procesu czyszczenia sprawdź folder danych dla dwóch plików. Można je otworzyć i obserwować, że są identyczne.
Czyszczenie zasobów
Po zweryfikowaniu plików i zakończeniu testowania naciśnij Enter , aby usunąć pliki testowe wraz z kontenerem utworzonym na koncie magazynu. Możesz również użyć interfejsu wiersza polecenia platformy Azure, aby usunąć zasoby.
Po zakończeniu pracy z przewodnikiem Szybki start możesz wyczyścić utworzone zasoby, uruchamiając następujące polecenie:
azd down
Zostanie wyświetlony monit o potwierdzenie usunięcia zasobów. Wprowadź , y
aby potwierdzić.