[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.]
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)
Usage
| Visual Basic |
|---|
Dim instance As CloudBlobContainer
Dim asyncResult As IAsyncResult
Dim returnValue As Boolean
returnValue = instance.EndCreateIfNotExist(asyncResult) |
Syntax
| Visual Basic |
|---|
Public Function EndCreateIfNotExist ( _
asyncResult As IAsyncResult _
) As Boolean |
| C# |
|---|
public bool EndCreateIfNotExist (
IAsyncResult asyncResult
) |
| C++ |
|---|
public:
bool EndCreateIfNotExist (
IAsyncResult^ asyncResult
) |
Parameters
- asyncResult
Type: System.IAsyncResult
An IAsyncResult that references the pending asynchronous operation.
Return Value
Type:
System.Booleantrue if the container did not already exist and was created; otherwise,
false.
Example
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.
| C# |  Copy Code |
|---|
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.");
}
else
{
Console.WriteLine("Container was not created because a container with that name already exists.");
}
}
|
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
Change History
See Also
