Snabbstart: Azure Blob Storage klientbibliotek v12 för .NET

Kom igång med Azure Blob Storage-klientbiblioteket v12 för .NET. Azure Blob Storage är Microsofts objektlagringslösning för molnet. Följ stegen för att installera paketet och prova exempelkoden för grundläggande uppgifter. Blob Storage är optimerad för lagring av enorma mängder ostrukturerade data.

Exemplen i den här snabbstarten visar hur du använder Azure Blob Storage-klientbiblioteket v12 för .NET för att:

• Hämta anslutningssträngen
• Skapa en container
• Ladda upp en blob till en container
• Lista blobar i en container
• Ladda ned en blob
• Ta bort en container

Ytterligare resurser:

• Referensdokumentation för API
• Bibliotekskällkod
• Paket (NuGet)
• Exempel

Förutsättningar

• Azure-prenumeration – skapa en kostnadsfritt
• Azure Storage-konto – skapa ett lagringskonto
• Aktuella .NET Core SDK för ditt operativsystem. Se till att hämta SDK och inte körningen.

Inrätta

Det här avsnittet går igenom hur du förbereder ett projekt för att arbeta med Azure Blob Storage-klientbiblioteket v12 för .NET.

Skapa projektet

Skapa ett .NET Core-program med namnet BlobQuickstartV12.

1. I ett konsolfönster (till exempel cmd, PowerShell eller Bash) använder du kommandot för att skapa en ny konsolapp med namnet dotnet new BlobQuickstartV12. Det här kommandot skapar ett enkelt "Hello World" C#-projekt med en enda källfil: Program.cs.

   dotnet new console -n BlobQuickstartV12
   

2. Växla till den nyligen skapade katalogen BlobQuickstartV12.

   cd BlobQuickstartV12
   

3. I katalogen BlobQuickstartV12 skapar du en annan katalog med namnet data. Det är här som blobdatafilerna skapas och lagras.

   mkdir data
   

Installera paketet

När du fortfarande är i programkatalogen installerar du Azure Blob Storage-klientbiblioteket för .NET-paketet med hjälp av dotnet add package kommandot .

dotnet add package Azure.Storage.Blobs

Konfigurera appramverket

Från projektkatalogen:

1. Öppna filen Program.cs i redigeringsprogrammet.

2. Ta bort Console.WriteLine("Hello World!"); -instruktionen.

3. Lägg using till direktiv.

4. Uppdatera Main metoddeklarationen för att stödja asynkronisering.

   Här är koden:

   using Azure.Storage.Blobs;
   using Azure.Storage.Blobs.Models;
   using System;
   using System.IO;
   using System.Threading.Tasks;
   
   namespace BlobQuickstartV12
   {
       class Program
       {
           static async Task Main()
           {
           }
       }
   }
   

Kopiera dina autentiseringsuppgifter från Azure-portalen

När exempelprogrammet gör en begäran till Azure Storage måste det auktoriserats. Om du vill auktorisera en begäran lägger du till autentiseringsuppgifterna för ditt lagringskonto i programmet som en anslutningssträng. Följ dessa steg om du vill visa autentiseringsuppgifterna för ditt lagringskonto:

1. Logga in på Azure-portalen.

2. Leta rätt på ditt lagringskonto.

3. I menyfönstret för lagringskontot går du till Säkerhet + nätverk och väljer Åtkomstnycklar. Här kan du visa kontoåtkomstnycklarna och den fullständiga anslutningssträngen för varje nyckel.

   

4. I fönstret Åtkomstnycklar väljer du Visa nycklar.

5. Leta upp värdet för Anslutningssträng i avsnittet key1. Välj ikonen Kopiera till Urklipp för att kopiera anslutningssträngen. Du lägger till anslutningssträngens värde i en miljövariabel i nästa avsnitt.

   

Konfigurera anslutningssträngen för lagring

När du har kopierat anslutningssträngen skriver du den till en ny miljövariabel på den lokala dator som kör programmet. Konfigurera miljövariabeln genom att öppna ett konsolfönster och följa anvisningarna för ditt operativsystem. Ersätt <yourconnectionstring> med den faktiska anslutningssträngen.

Windows

setx AZURE_STORAGE_CONNECTION_STRING "<yourconnectionstring>"

När du har lagt till miljövariabeln i Windows måste du starta en ny instans av kommandofönstret.

Linux

export AZURE_STORAGE_CONNECTION_STRING="<yourconnectionstring>"

macOS

export AZURE_STORAGE_CONNECTION_STRING="<yourconnectionstring>"

Starta om program

När du har lagt till miljövariabeln startar du om alla program som körs och behöver läsa miljövariabeln. Du kan till exempel starta om utvecklingsmiljön eller redigeringsredigeraren innan du fortsätter.

Objektmodell

Azure Blob Storage är optimerad för att lagra stora mängder ostrukturerade data. Ostrukturerade data är data som inte följer en viss datamodell eller definition, till exempel text eller binära data. I blobblagringen finns tre typer av resurser:

• Lagringskontot
• En container på lagringskontot
• En blob i containern

Följande diagram visar relationen mellan de här resurserna.

Använd följande .NET-klasser för att interagera med dessa resurser:

• BlobServiceClient:Med BlobServiceClient klassen kan du ändra Azure Storage och blobcontainrar.
• BlobContainerClient:Med BlobContainerClient klassen kan du ändra Azure Storage och deras blobar.
• BlobClient:Med BlobClient klassen kan du ändra Azure Storage blobar.

Kodexempel

Exempelkodfragmenten i följande avsnitt visar hur du utför grundläggande dataåtgärder med Azure Blob Storage klientbiblioteket för .NET.

Hämta anslutningssträngen

Koden nedan hämtar anslutningssträngen för lagringskontot från miljövariabeln som skapades i avsnittet Konfigurera lagringsanslutningssträngen.

Lägg till den här koden i Main metoden :

Console.WriteLine("Azure Blob Storage v12 - .NET quickstart sample\n");

// Retrieve the connection string for use with the application. The storage
// connection string is stored in an environment variable on the machine
// running the application called AZURE_STORAGE_CONNECTION_STRING. If the
// environment variable is created after the application is launched in a
// console or with Visual Studio, the shell or application needs to be closed
// and reloaded to take the environment variable into account.
string connectionString = Environment.GetEnvironmentVariable("AZURE_STORAGE_CONNECTION_STRING");

Skapa en container

Bestäm ett namn för den nya containern. Koden nedan lägger till ett GUID-värde i containernamnet för att säkerställa att det är unikt.

Skapa en instans av klassen BlobServiceClient. Anropa sedan metoden CreateBlobContainerAsync för att skapa containern i ditt lagringskonto.

Lägg till den här koden i slutet av Main metoden:

// Create a BlobServiceClient object which will be used to create a container client
BlobServiceClient blobServiceClient = new BlobServiceClient(connectionString);

//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);

Ladda upp en blob till en container

Följande kodfragment:

1. Skapar en textfil i den lokala datakatalogen.
2. Hämtar en referens till ett BlobClient-objekt genom att anropa metoden GetBlobClient i containern från avsnittet Skapa en container.
3. Laddar upp den lokala textfilen till bloben genom att anropa metoden UploadAsync. Den här metoden skapar bloben om den inte redan finns, och skriver över den om den finns.

Lägg till den här koden i slutet av Main metoden:

// Create a local file in the ./data/ directory for uploading and downloading
string localPath = "./data/";
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);

Lista blobar i en container

Visa en lista över blobarna i containern genom att anropa metoden GetBlobsAsync. I det här fallet har endast en blob lagts till i containern, så liståtgärden returnerar bara den bloben.

Lägg till den här koden i slutet av Main metoden:

Console.WriteLine("Listing blobs...");

// List all blobs in the container
await foreach (BlobItem blobItem in containerClient.GetBlobsAsync())
{
    Console.WriteLine("\t" + blobItem.Name);
}

Ladda ned en blob

Ladda ned bloben som du skapade tidigare genom att anropa metoden DownloadToAsync. Exempelkoden lägger till suffixet "DOWNLOADED" i filnamnet så att du kan se båda filerna i det lokala filsystemet.

Lägg till den här koden i slutet av Main metoden:

// 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);

Ta bort en container

Följande kod rensar de resurser som appen skapade genom att ta bort hela containern med hjälp av DeleteAsync. Den tar även bort de lokala filer som skapats av appen.

Appen pausar för användarindata genom att Console.ReadLine anropa innan den tar bort bloben, containern och lokala filer. Det här är en bra chans att kontrollera att resurserna faktiskt har skapats korrekt, innan de tas bort.

Lägg till den här koden i slutet av Main metoden:

// 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");

Kör koden

Den här appen skapar en testfil i din lokala datamapp och laddar upp den till Blob Storage. Exemplet visar sedan blobarna i containern och laddar ned filen med ett nytt namn så att du kan jämföra de gamla och nya filerna.

Gå till programkatalogen och skapa och kör sedan programmet.

dotnet build

dotnet run

Appens utdata liknar följande exempel:

Azure Blob Storage v12 - .NET quickstart sample

Uploading to Blob storage as blob:
         https://mystorageacct.blob.core.windows.net/quickstartblobs60c70d78-8d93-43ae-954d-8322058cfd64/quickstart2fe6c5b4-7918-46cb-96f4-8c4c5cb2fd31.txt

Listing blobs...
        quickstart2fe6c5b4-7918-46cb-96f4-8c4c5cb2fd31.txt

Downloading blob to
        ./data/quickstart2fe6c5b4-7918-46cb-96f4-8c4c5cb2fd31DOWNLOADED.txt

Press any key to begin clean up
Deleting blob container...
Deleting the local source and downloaded files...
Done

Innan du påbörjar rensningsprocessen kontrollerar du datamappen för de två filerna. Du kan öppna dem och se att de är identiska.

När du har verifierat filerna trycker du på Retur för att ta bort testfilerna och avsluta demonstrationen.

Nästa steg

I den här snabbstarten har du lärt dig att ladda upp, ladda ned och lista blobar med hjälp av .NET.

Om du vill se Blob Storage-exempelappar fortsätter du till:

• Självstudier, exempel, snabbstarter och annan dokumentation finns i Azure för .NET- och .NET Core-utvecklare.
• Mer information om .NET Core finns i Kom igång med .NET på 10 minuter.