Quickstart: Azure Blob Storage clientbibliotheek v12 voor .NET

Ga aan de slag met de Azure Blob Storage-clientbibliotheek v12 voor .NET. Azure Blob Storage is de oplossing voor opslag van objecten in de cloud van Microsoft. Volg de stappen om het pakket te installeren en voorbeeldcode voor basistaken uit te proberen. Blob Storage is geoptimaliseerd voor het opslaan van grote hoeveelheden ongestructureerde gegevens.

In de voorbeelden in deze quickstart ziet u hoe u de Azure Blob Storage clientbibliotheek v12 voor .NET gebruikt voor het volgende:

• De verbindingsreeks ophalen
• Een container maken
• Een blob uploaden naar een container
• Blobs in een container opslijst
• Blob downloaden
• Container verwijderen

Aanvullende bronnen:

• API-referentiedocumentatie
• Broncode van bibliotheek
• Pakket (NuGet)
• Voorbeelden

Vereisten

• Azure-abonnement: u kunt een gratis abonnement nemen
• Azure Storage-account: maak een opslagaccount
• De huidige versie van de .NET Core SDK voor uw besturingssysteem. Zorg ervoor dat u de SDK en niet de runtime ophaalt.

Instellen

Deze sectie helpt u bij het voorbereiden van een project om te werken met de Azure Blob Storage-clientbibliotheek v12 voor .NET.

Het project maken

Maak een .NET Core-toepassing met de naam BlobQuickstartV12.

1. Gebruik in een consolevenster (zoals cmd, PowerShell of Bash) de opdracht dotnet new om een nieuwe console-app te maken met de naam BlobQuickstartV12. Met deze opdracht maakt u een eenvoudig Hallo wereld-C#-project met één bronbestand: Program.cs.

   dotnet new console -n BlobQuickstartV12
   

2. Schakel over naar de zojuist gemaakte map BlobQuickstartV12.

   cd BlobQuickstartV12
   

3. Maak een andere map met de naam gegevens in de map BlobQuickstartV12. Hier worden de blob-gegevensbestanden gemaakt en opgeslagen.

   mkdir data
   

Het pakket installeren

Blijf in de toepassingsmap en installeer de Azure Blob Storage-clientbibliotheek voor het .NET-pakket met behulp van de opdracht dotnet add package.

dotnet add package Azure.Storage.Blobs

Het app-framework instellen

Ga als volgt te werk vanuit de projectmap:

1. Open het bestand Program.cs in uw editor.

2. Verwijder de Console.WriteLine("Hello World!"); instructie .

3. Voeg using -instructies toe.

4. Werk de Main methodedeclaratie bij om async te ondersteunen.

   Hier volgt de code:

   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()
           {
           }
       }
   }
   

Kopieer uw referenties van de Azure Portal

Wanneer met de voorbeeldtoepassing een aanvraag wordt ingediend bij Azure Storage, moet deze aanvraag worden geautoriseerd. Om een aanvraag te autoriseren voegt u de referenties van uw opslagaccount toe als een verbindingsreeks. Volg deze stappen om uw opslagaccountreferenties te bekijken:

1. Meld u aan bij Azure Portal.

2. Zoek uw opslagaccount.

3. Selecteer in het menudeelvenster van het opslagaccount onder Beveiliging en netwerken de optie Toegangssleutels. Hier kunt u de toegangssleutels voor het account en de volledige connection string voor elke sleutel weergeven.

   

4. Selecteer sleutels weergeven in het deelvenster Toegangssleutels.

5. Zoek in de sectie key1 de waarde van de verbindingsreeks. Selecteer het pictogram Kopiëren naar klembord om de connection string. In de volgende sectie voegt connection string waarde toe aan een omgevingsvariabele.

   

De opslagverbindingsreeks configureren

Nadat u de connection string, schrijft u deze naar een nieuwe omgevingsvariabele op de lokale computer met de toepassing. Als u de omgevingsvariabele wilt instellen, opent u een consolevenster en volgt u de aanwijzingen voor uw besturingssysteem. Vervang <yourconnectionstring> door de feitelijke verbindingsreeks.

Windows

setx AZURE_STORAGE_CONNECTION_STRING "<yourconnectionstring>"

Nadat u de omgevingsvariabele in Windows hebt toegevoegd, moet u een nieuw exemplaar van het opdrachtvenster starten.

Linux

export AZURE_STORAGE_CONNECTION_STRING="<yourconnectionstring>"

macOS

export AZURE_STORAGE_CONNECTION_STRING="<yourconnectionstring>"

Programma's opnieuw opstarten

Nadat u de omgevingsvariabele hebt toegevoegd, start u actieve programma's die de omgevingsvariabele moeten lezen, opnieuw. Start bijvoorbeeld uw ontwikkelomgeving of editor opnieuw op voordat u doorgaat.

Objectmodel

Azure Blob Storage is geoptimaliseerd voor het opslaan van grote hoeveelheden ongestructureerde gegevens. Ongestructureerde gegevens zijn gegevens die niet voldoen aan een bepaald gegevensmodel of bepaalde definitie, zoals tekst of binaire gegevens. Er zijn drie typen resources voor blobopslag:

• Het opslagaccount
• Een container in het opslagaccount
• Een blob in de container

Het volgende diagram geeft de relatie tussen deze resources weer.

Gebruik de volgende .NET-klassen om te communiceren met deze resources:

• BlobServiceClient: Met de klasse BlobServiceClient kunt u Azure Storage-resources en blob-containers bewerken.
• BlobContainerClient: Met de klasse BlobContainerClient kunt u Azure Storage-containers en de bijbehorende blobs bewerken.
• BlobClient: Met de klasse BlobClient kunt u Azure Storage-blobs bewerken.

Codevoorbeelden

De voorbeeldcodefragmenten in de volgende secties laten zien hoe u eenvoudige gegevensbewerkingen kunt uitvoeren met de Azure Blob Storage-clientbibliotheek voor .NET.

De verbindingsreeks ophalen

De onderstaande code haalt de verbindingstekenreeks voor het opslagaccount op van de omgevingsvariabele die is gemaakt in de sectie De opslagverbindingsreeks configureren.

Voeg deze code toe in de methode Main:

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

Een container maken

Verzin een naam voor de nieuwe container. Met de onderstaande code wordt een GUID-waarde aan de containernaam toegevoegd om te verzekeren dat deze uniek is.

Een instantie van de klasse BlobServiceClient maken. Roep vervolgens de methode CreateBlobContainerAsync aan om de container in uw opslagaccount te maken.

Voeg deze code toe aan het einde van de Main-methode:

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

Een blob uploaden naar een container

Het volgende codefragment:

1. Hiermee maakt u een tekstbestand in de lokale map gegevens.
2. Hiermee wordt een verwijzing naar een BlobClient-object opgehaald door de methode GetBlobClient aan te roepen voor de container vanuit de sectie Een container maken.
3. Hiermee wordt het lokale tekstbestand geüpload naar de blob door de methode UploadAsync aan te roepen. Met deze methode wordt de blob gemaakt als deze nog niet bestaat, of overschreven als dat wel het geval is.

Voeg deze code toe aan het einde van de Main-methode:

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

Blobs in een container opslijst

Hiermee worden de blobs in de container weergegeven door de methode GetBlobsAsync aan te roepen. In dit geval is slechts één blob aan de container toegevoegd, zodat met de weergavebewerking alleen die ene blob wordt geretourneerd.

Voeg deze code toe aan het einde van de Main-methode:

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

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

Een blob downloaden

Download de eerder gemaakte blob door de methode DownloadToAsync aan te roepen. Met de voorbeeldcode wordt het achtervoegsel 'DOWNLOADED' toegevoegd aan de naam van het bestand, zodat u beide bestanden in het lokale bestandssysteem kunt zien.

Voeg deze code toe aan het einde van de Main-methode:

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

Een container verwijderen

Met de volgende code worden de resources opgeruimd die door de app zijn gemaakt door de hele container te verwijderen met behulp van DeleteAsync. Ook worden de lokale bestanden verwijderd die door de app zijn gemaakt.

De app pauzeert voor gebruikersinvoer door Console.ReadLine aan te roepen voordat deze de blob, container en lokale bestanden verwijdert. Dit is een goede gelegenheid om te controleren of de resources daadwerkelijk correct zijn gemaakt, voordat ze worden verwijderd.

Voeg deze code toe aan het einde van de Main-methode:

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

De code uitvoeren

Met deze app wordt een testbestand gemaakt in uw lokale map gegevens en geüpload naar de Blob-opslag. Vervolgens wordt een lijst gemaakt van de blobs in de container en wordt het bestand gedownload met een nieuwe naam, zodat u het oude en nieuwe bestand kunt vergelijken.

Navigeer naar de toepassingsmap, bouw de toepassing en voer deze uit.

dotnet build

dotnet run

De uitvoer van de app lijkt op die in het volgende voorbeeld:

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

Voordat u begint met opschonen, controleert u of de twee bestanden zich in de map gegevens bevinden. Als u ze opent, ziet u dat ze identiek zijn.

Nadat u de bestanden hebt gecontroleerd, drukt u op Enter om de testbestanden te verwijderen en het voorbeeld te voltooien.

Volgende stappen

In deze snelstart hebt u geleerd hoe u blobs kunt uploaden, downloaden en er een lijst van maken met behulp van .NET.

Als u voorbeeld-apps voor Blob-opslag wilt zien, ga dan naar:

• Ga naar Azure voor .NET- en .NET Core-ontwikkelaars voor zelfstudies, voorbeelden, quickstarts en andere documentatie.
• Zie voor meer informatie over .NET Core Aan de slag met .NET in 10 minuten.