官术网_书友最值得收藏!

Downloading a blob asynchronously

The Windows Azure Storage Client library provides synchronous and asynchronous versions of nearly all the methods that access the Windows Azure Storage Service.

The asynchronous methods follow the common language runtime (CLR) Asynchronous Programming Model (APM). In this model, asynchronous methods for an action are defined as a pair named BeginAction and EndAction. The asynchronous operation is initiated through a call to BeginAction and is cleaned up by a call to EndAction. BeginAction has a parameter that is a callback delegate and EndAction must be invoked in that delegate.

This apparent complexity can be greatly simplified through the use of a lambda expression to represent the callback delegate. Furthermore, local variables defined in the method containing the lambda expression are available inside the lambda expression. This removes any difficulty caused by a need to pass variables into the delegate. Using a lambda expression, instead of a callback delegate, makes using the asynchronous methods almost as simple as using the synchronous methods.

In this recipe, we will learn how to use asynchronous methods to download a blob into a file.

How to do it...

We are going to download a blob asynchronously. We do this as follows:

  1. Add a new class named DownloadBlobExample to the project.
  2. Set the Target Framework for the project to .NET Framework 4.
  3. Add the following assembly references to the project:
    Microsoft.WindowsAzure.StorageClient
    System.Configuration
  4. Add the following using statements to the top of the class file:
    using Microsoft.WindowsAzure;
    using Microsoft.WindowsAzure.StorageClient;
    using System.Configuration;
    using System.Net;
    using System.IO;
  5. Add the following method, creating a container and blob, to the class:
    private static void CreateContainerAndBlob(String containerName, String blobName)
    {
      CloudStorageAccount cloudStorageAccount =CloudStorageAccount.Parse(ConfigurationManager.AppSettings[
        "DataConnectionString"]);
      CloudBlobClient cloudBlobClient =cloudStorageAccount.CreateCloudBlobClient();
    
      CloudBlobContainer cloudBlobContainer =cloudBlobClient.GetContainerReference(containerName);
      cloudBlobContainer.CreateIfNotExist();
    
      CloudBlockBlob cloudBlockBlob =cloudBlobContainer.GetBlockBlobReference(blobName);
      cloudBlockBlob.UploadText("To be, or not to be");
    }
  6. Add the following method, downloading a blob, to the class:
    private static void DownloadBlob(String containerName,String blobName, String fileName)
    {
      CloudStorageAccount cloudStorageAccount =CloudStorageAccount.Parse(ConfigurationManager.AppSettings["DataConnectionString"]);
      CloudBlobClient cloudBlobClient =cloudStorageAccount.CreateCloudBlobClient();
    
      CloudBlobContainer cloudBlobContainer =cloudBlobClient.GetContainerReference(containerName);
      CloudBlockBlob cloudBlockBlob =cloudBlobContainer.GetBlockBlobReference(blobName);
    
      FileStream fileStream = new FileStream(fileName,FileMode.Append);
      IAsyncResult iAsyncResult =cloudBlockBlob.BeginDownloadToStream(fileStream,(result) =>
        {
          cloudBlockBlob.EndDownloadToStream(result);
          fileStream.Close();
        },
        null);
      return;
    }
  7. Add the following method, using the methods added earlier, to the class:
    public static void UseDownloadBlobExample()
    {
      String containerName = "{CONTAINER_NAME}";
      String blobName = "{BLOB_NAME}";
      String fileName = Path.GetTempPath() + @"\{FILE_NAME}";
    
      CreateContainerAndBlob(containerName, blobName);
      DownloadBlob(containerName, blobName, fileName);
    }
  8. Add the following to the configuration section of app.config:
    <appSettings>
      <add key="DataConnectionString"value="UseDevelopmentStorage=true"/>
    </appSettings>

How it works...

In steps 1 through 4, we set up the class. In step 5, we initialize a CloudStorageAccount from app.config and use it to create a CloudBlobClient instance. We use this to create a container and a blob.

In step 6, we follow the same route to get a CloudBlockBlob reference to the blob. We use it to invoke the BeginDownloadToStream() method. We pass this a lambda expression, instead of a callback delegate, and invoke EndDownloadToStream() in the lambda expression to clean up the asynchronous call. We use the ability to refer to local objects from inside the lambda expression to close the FileStream used in the download.

In step 7, we add a method that sets the parameters for the call to DownloadBlob(). We download the blob to a temp directory. We must replace {CONTAINER_NAME} and {BLOB_NAME} with appropriate container and blob names, and {FILE_NAME} with the file name.

In step 8, we add the connection string to the app.config configuration file.

主站蜘蛛池模板: 广汉市| 深水埗区| 连城县| 扎鲁特旗| 隆子县| 望江县| 百色市| 奇台县| 苏州市| 义乌市| 海南省| 禄丰县| 那曲县| 渭源县| 屏东县| 格尔木市| 铁岭县| 七台河市| 芦山县| 金堂县| 通城县| 宁陵县| 鹤壁市| 明水县| 肃北| 大新县| 金坛市| 琼结县| 吉林省| 同德县| 广东省| 辽源市| 岚皋县| 锡林浩特市| 靖宇县| 平南县| 浮梁县| 牟定县| 富锦市| 堆龙德庆县| 光山县|