AsyncPageable<T> Class

Definition

Namespace:

Azure

Assembly:

Azure.Core.dll

Package:

Azure.Core v1.45.0

Source:

AsyncPageable.cs

A collection of values that may take multiple service requests to iterate over.

C#

public abstract class AsyncPageable<T> : System.Collections.Generic.IAsyncEnumerable<T>

Type Parameters

T

The type of the values.

Inheritance

Object

AsyncPageable<T>

Implements

IAsyncEnumerable<T>

Examples

Example of enumerating an AsyncPageable using the async foreach loop:

C#

// call a service method, which returns AsyncPageable<T>
AsyncPageable<SecretProperties> allSecretProperties = client.GetPropertiesOfSecretsAsync();

await foreach (SecretProperties secretProperties in allSecretProperties)
{
    Console.WriteLine(secretProperties.Name);
}

or using a while loop:

C#

// call a service method, which returns AsyncPageable<T>
AsyncPageable<SecretProperties> allSecretProperties = client.GetPropertiesOfSecretsAsync();

IAsyncEnumerator<SecretProperties> enumerator = allSecretProperties.GetAsyncEnumerator();
try
{
    while (await enumerator.MoveNextAsync())
    {
        SecretProperties secretProperties = enumerator.Current;
        Console.WriteLine(secretProperties.Name);
    }
}
finally
{
    await enumerator.DisposeAsync();
}

Constructors

AsyncPageable<T>()	Initializes a new instance of the AsyncPageable<T> class for mocking.
AsyncPageable<T>(CancellationToken)	Initializes a new instance of the AsyncPageable<T> class.

Properties

CancellationToken

Gets a CancellationToken used for requests made while enumerating asynchronously.

Methods

AsPages(String, Nullable<Int32>)	Enumerate the values a Page<T> at a time. This may make multiple service requests.
FromPages(IEnumerable<Page<T>>)	Creates an instance of Pageable<T> using the provided pages.
GetAsyncEnumerator(CancellationToken)	Enumerate the values in the collection asynchronously. This may make multiple service requests.

Applies to