CloudQueue.BeginCreate Method

using System;
using Microsoft.WindowsAzure;
using Microsoft.WindowsAzure.StorageClient;

namespace QueueAsyncExample
{
  public class QueueAsyncStateExample
  {
    public CloudQueue queueObject;
    public object customStateInformation;

    // Constructor for the example state class
    public QueueAsyncStateExample( CloudQueue queue, object yourAdditionalStateObject )
    {
      this.queueObject = queue;
      this.customStateInformation = yourAdditionalStateObject;
    }

    // Static call that starts creating a queue (the queue should not already exist)
    //-----------------
    //  IMPORTANT NOTE
    //--------------------------------------------------------------------
    //  The form of a queue name is constrained as follows:
    //  -- It must ONLY contain lowercase letters, numbers, and hyphens.
    //  -- It must be between 3 and 63 characters long.
    //  -- It must begin and end with a lowercase letter or number.
    //  -- It may NOT contain contiguous hyphens ("--").
    //--------------------------------------------------------------------
    static CloudQueue CreateQueueAsync( string queueName, CloudQueueClient queueClient, object stateObject )
    {
      CloudQueue queue = queueClient.GetQueueReference( queueName );
      queue.BeginCreate( QueueCreateCallback,
                        new QueueAsyncStateExample( queue, stateObject ) );
      return ( queue );  // (note that the queue creation is not yet complete!)
    }

    // The callback method that is called once the create operation is complete
    static void QueueCreateCallback( IAsyncResult opResult )
    {
      QueueAsyncStateExample state = (QueueAsyncStateExample) opResult.AsyncState;
      CloudQueue queue = state.queueObject;
      // End the BeginCreate operation
      queue.EndCreate( opResult );
      // ...other asynchronous operations could be started here if appropriate
    }
  }
}