CloudBlobContainer.EndCreate Method

Storage Client Library NET API

[This topic is part of the Microsoft Azure Storage Client Library 1.7, which has been deprecated. See Storage Client Library for the latest version.]

Ends an asynchronous operation to create a container.

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

Usage

Visual Basic
Dim instance As CloudBlobContainer
Dim asyncResult As IAsyncResult

instance.EndCreate(asyncResult)

Syntax

Visual Basic
Public Sub EndCreate ( _
	asyncResult As IAsyncResult _
)
C#
public void EndCreate (
	IAsyncResult asyncResult
)
C++
public:
void EndCreate (
	IAsyncResult^ asyncResult
)
J#
JScript

Parameters

asyncResult

Type: System.IAsyncResult

An IAsyncResult that references the pending asynchronous operation.

Example

The following code example creates a new container and defines metadata for it, and handles the error in case a container with the same name already exists.

C# Copy Code
static void CreateContainerAsync(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"] = "video";

    //Begin the operation to create the container.
    container.BeginCreate(CreateContainerCallback, container);
}

static void CreateContainerCallback(IAsyncResult result)
{
    CloudBlobContainer container = (CloudBlobContainer)result.AsyncState;
            
    //End the operation. Handle the error in case the container already exists.
    try
    {
        container.EndCreate(result);
        Console.WriteLine("Container " + container.Name + " created successfully.");
    }
    catch (StorageClientException e)
    {
        if (e.ErrorCode == StorageErrorCode.ContainerAlreadyExists)
        {
            Console.WriteLine("Cannot create the container because it already exists.");
        }
        else
        {
            Console.WriteLine(e.ErrorCode);
        }
    }
}

Thread Safety

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

Platforms

Development Platforms

Windows Vista, Windows 7, Windows Server 2008, Windows 8.1, Windows Server 2012 R2, Windows 8 and Windows Server 2012

Change History

See Also