victorchin / storage-blob-dotnet-getting-started

The getting started sample demonstrates how to perform common tasks using the Azure Blob Service in .NET including uploading a blob, CRUD operations, listing, as well as blob snapshot creation.

page_type	languages	products	description	urlFragment
sample	csharp	azure	Demonstrates how to use the Blob Storage service.	storage-blob-dotnet-getting-started

Azure Blob Storage Samples for .NET

Demonstrates how to use the Blob Storage service. Blob storage stores unstructured data such as text, binary data, documents or media files. Blobs can be accessed from anywhere in the world via HTTP or HTTPS.

Note: This sample uses the .NET Framework 4.7.2 asynchronous programming model to demonstrate how to call Azure Storage using asynchronous API calls. When used in real applications, this approach enables you to improve the responsiveness of your application. Calls to Azure Storage are prefixed by the await keyword. For more information about asynchronous programming using the Async/Await pattern, see Asynchronous Programming with Async and Await (C# and Visual Basic).

If you don't already have a Microsoft Azure subscription, you can get a FREE trial account here.

Running this sample

This sample can be run using either the Azurite emulator that installs as part of this SDK - or by updating the App.Config file with your AccountName and Key. To run the sample using the emulator (default option):

1. Install the mkcert here.
2. Clone Azurite to local here.
3. After cloning source code, execute following commands to install Azurite V3.

npm ci
npm run build
npm install -g

4. After intalling Azurite, execute following commands to start Azurite V3.

mkcert -install
mkcert certname
azurite --oauth basic --cert certname.pem --key certname-key.pem

5. Set breakpoints and run the project using F10.

To run the sample using the Storage Service

1. Open the app.config file. Comment out the connection string and account for the Azurite. Uncomment the connection string and account for the Storage service (AccountName=[]...).
2. Create a Storage Account through the Azure Portal and provide your [AccountName] and [AccountKey] in the App.Config file.
3. Set breakpoints and run the project using F10.

More information

• How to create, manage, or delete a storage account in the Azure Portal
• Get started with Azure Blob storage (object storage) using .NET
• Blob Service Concepts
• Blob Service REST API
• Blob Service C# API
• Delegating Access with Shared Access Signatures
• Azurite
• Asynchronous Programming with Async and Await