CloudBlobClient.EndListContainersSegmented 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 return a result segment containing a collection of containers.

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

Usage

Visual Basic
Dim instance As CloudBlobClient
Dim asyncResult As IAsyncResult
Dim returnValue As ResultSegment(Of CloudBlobContainer)

returnValue = instance.EndListContainersSegmented(asyncResult)

Syntax

Visual Basic
Public Function EndListContainersSegmented ( _
	asyncResult As IAsyncResult _
) As ResultSegment(Of CloudBlobContainer)
C#
public ResultSegment<CloudBlobContainer> EndListContainersSegmented (
	IAsyncResult asyncResult
)
C++
public:
ResultSegment<CloudBlobContainer^>^ EndListContainersSegmented (
	IAsyncResult^ asyncResult
)
J#
JScript

Parameters

asyncResult

Type: System.IAsyncResult

An IAsyncResult that references the pending asynchronous operation.

Return Value

Type: Microsoft.WindowsAzure.StorageClient.ResultSegment

A result segment of containers.

Example

The following code sample lists containers in the storage account asynchronously, in result segments of ten containers at a time.

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

    //Begin the operation to return the first segment of 10 containers in the account.
    blobClient.BeginListContainersSegmented(
        "", ContainerListingDetails.None, 10, null, ListContainersInSegmentsCallback, blobClient);
}

static void ListContainersInSegmentsCallback(IAsyncResult result)
{
    CloudBlobClient blobClient = (CloudBlobClient)result.AsyncState;
    ResultSegment<CloudBlobContainer> resultSegment = blobClient.EndListContainersSegmented(result);

    //Enumerate the containers.
    foreach (var container in resultSegment.Results)
    {
        Console.WriteLine(container.Name);
    }

    //Check whether the page is complete.
    if (resultSegment.HasMoreResults)
    {
        resultSegment = resultSegment.GetNext();

        //Enumerate the containers.
        foreach (var container in resultSegment.Results)
        {
            Console.WriteLine(container.Name);
        }
    }
}

Remarks

This method blocks until the listing operation is complete.


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