Export (0) Print
Expand All

CloudBlobContainer.SetMetadata Method (BlobRequestOptions)

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.]

Sets the container's user-defined metadata, using a conditional request based on the BlobRequestOptions that you specify.

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


Public Sub SetMetadata ( _
	options As BlobRequestOptions _



Type: Microsoft.WindowsAzure.StorageClient.BlobRequestOptions

An object that specifies any additional options for the request.

The following code example defines some metadata for a container and writes it to the container.

static void WriteContainerMetadata(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));

    //Return a container reference.
    CloudBlobContainer container = new CloudBlobContainer("mycontainer", blobClient);

    //Create the container if it does not exist.

    //Define some metadata for the container.
    container.Metadata["category"] = "images";
    container.Metadata["owner"] = "azureix";

    //Write the metadata to the service. Set a retry policy on the call.
        new BlobRequestOptions() 
            { RetryPolicy = RetryPolicies.RetryExponential(10, RetryPolicies.DefaultClientBackoff) } 

The SetMetadata method writes the metadata values that are specified by the container's Metadata property to the service. Note that setting the Metadata property sets metadata values on the blob reference only; you must call SetMetadata or BeginSetMetadata to write them to the service.

You can also set metadata on a container when the container is created, without calling SetMetadata.

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

© 2014 Microsoft