SALES: 1-800-867-1380

CloudBlobContainer.EndCreateIfNotExist Method

Updated: April 24, 2013

[This topic is part of the Windows Azure Storage Client Library 1.7, which has been deprecated. The current recommended version is Storage Client Library 3.0.]

Returns the result of an asynchronous request to create the container if it does not already exist.

Namespace: Microsoft.WindowsAzure.StorageClient
Assembly: Microsoft.WindowsAzure.StorageClient (in Microsoft.WindowsAzure.StorageClient.dll)


public bool EndCreateIfNotExist (
	IAsyncResult asyncResult



Type: System.IAsyncResult

An IAsyncResult that references the pending asynchronous operation.

Return Value

Type: System.Boolean

true if the container did not already exist and was created; otherwise, false.

The following code example creates a container if it does not already exist. Note that if the container does already exist, its metadata will not be updated.

static void CreateContainerIfNotExistsAsync(Uri blobEndpoint, string accountName, string accountKey)
    //Create service client for credentialed access to the Blob service.
    CloudBlobClient blobClient = new CloudBlobClient(blobEndpoint, new StorageCredentialsAccountAndKey(accountName, accountKey));

    //Get a reference for the new container.
    CloudBlobContainer container = blobClient.GetContainerReference("newcontainer");

    //Define metadata for the container.
    container.Metadata["media"] = "images";

    //Begin the operation to create the container.
    container.BeginCreateIfNotExist(CreateContainerIfNotExistsCallback, container);

static void CreateContainerIfNotExistsCallback(IAsyncResult result)
    CloudBlobContainer container = (CloudBlobContainer)result.AsyncState;
    //End the operation and indicate whether the container was created.
    if (container.EndCreateIfNotExist(result))
        Console.WriteLine("Container created successfully.");
        Console.WriteLine("Container was not created because a container with that name already exists.");

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Development Platforms

Windows Vista, Windows 7 and Windows Server 2008

Target Platforms

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
© 2014 Microsoft