CloudBlobClient.ListContainers Method (String)

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

Returns an enumerable collection of containers whose names begin with the specified prefix.

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

Usage

Visual Basic
Dim instance As CloudBlobClient
Dim prefix As String
Dim returnValue As IEnumerable(Of CloudBlobContainer)

returnValue = instance.ListContainers(prefix)

Syntax

Visual Basic
Public Function ListContainers ( _
	prefix As String _
) As IEnumerable(Of CloudBlobContainer)
C#
public IEnumerable<CloudBlobContainer> ListContainers (
	string prefix
)
C++
public:
IEnumerable<CloudBlobContainer^>^ ListContainers (
	String^ prefix
)
J#
JScript

Parameters

prefix

Type: System.String

The container name prefix.

Return Value

Type: System.Collections.Generic.IEnumerable

An enumerable collection of containers.

Example

The following code example demonstrates a few different options for listing containers in a storage account.

C# Copy Code
static void ListContainersInAccount(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));

    //List all containers in this storage account.
    foreach (var container in blobClient.ListContainers())
    {
        Console.WriteLine("Container:" + container.Name);
    }
    Console.WriteLine();

    //List containers in this storage account whose names begin with the prefix "my".
    foreach (var container in blobClient.ListContainers("my"))
    {
        Console.WriteLine("Container:" + container.Name);
    }
    Console.WriteLine();

    //List containers in this storage account whose names begin with the prefix "my", 
    //and return container metadata.
    //Note that requesting the container's metadata as part of the listing operation 
    //populates the metadata, so it's not necessary to call FetchAttributes().
    foreach (var container in blobClient.ListContainers("my", ContainerListingDetails.Metadata))
    {
        Console.WriteLine("Container:" + container.Name);
        //Write out the container's metadata values.
        Console.WriteLine("Container metadata:");
        foreach (var metadataKey in container.Metadata.Keys)
        {
            Console.WriteLine("\tMetadata key: " + metadataKey.ToString());
            Console.WriteLine("\tMetadata value: " + container.Metadata.Get(metadataKey.ToString()));
        }
    }
}

Remarks

This method lists all containers in the storage account whose names begin with the specified prefix.


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