This topic has not yet been rated - Rate this topic

CloudBlobClient.GetContainerReference Method

Returns a reference to a CloudBlobContainer object with the specified address.

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

Usage

'Usage
Dim instance As CloudBlobClient
Dim containerAddress As String
Dim returnValue As CloudBlobContainer

returnValue = instance.GetContainerReference(containerAddress)

Syntax

C++

public CloudBlobContainer GetContainerReference (
	string containerAddress
)

public CloudBlobContainer GetContainerReference (
	String containerAddress
)

JScript

public function GetContainerReference (
	containerAddress : String
) : CloudBlobContainer

Parameters

containerAddress

Type: System.String

The name of the container, or an absolute URI to the container.

Return Value

Type: Microsoft.WindowsAzure.StorageClient.CloudBlobContainer

A reference to a container.

Remarks

The GetContainerReference method returns a reference to the named container, but it does not indicate whether the container exists, as it does not make a round-trip to the service. If you need to ascertain the existence of the container, call a method such as FetchAttributes, and handle the resulting StorageClientException in the event the blob does not exist. The FetchAttributes method executes a HEAD request to populate the properties and metadata of the blob and as such is a lightweight option for determining whether the blob exists.

Note
When you specify a container name in the parameter, you must be aware of the character limitations related to container names. For more information, see Naming and Referencing Containers, Blobs, and Metadata.

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 and Windows Server 2008

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

CloudBlobClient.GetContainerReference Method

Parameters

Return Value

Development Platforms

Target Platforms

Reference

Other Resources