QueryResponse<T>.MoveNextAsync(QueryOptions, CancellationToken) Méthode

Référence

Définition

Espace de noms:: Microsoft.Azure.Devices

Assembly:: Microsoft.Azure.Devices.dll

Paquet:: Microsoft.Azure.Devices v2.0.0-preview002

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Passe à l’élément suivant des résultats de la requête.

public System.Threading.Tasks.Task<bool> MoveNextAsync (Microsoft.Azure.Devices.QueryOptions queryOptions = default, System.Threading.CancellationToken cancellationToken = default);

member this.MoveNextAsync : Microsoft.Azure.Devices.QueryOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Function MoveNextAsync (Optional queryOptions As QueryOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Boolean)

Paramètres

queryOptions: QueryOptions

cancellationToken: CancellationToken

Retours

Task<Boolean>

True s’il y avait un élément suivant dans les résultats de la requête. False s’il n’y avait plus d’éléments.

Exceptions

IotHubServiceException

Si cette méthode a demandé à IoT Hub d’obtenir la page suivante des éléments, mais qu’IoT Hub a répondu à la demande avec un code status non réussi. Par exemple, si la requête fournie a été limitée, IotHubServiceException avec ThrottlingException est levée. Pour obtenir la liste complète des cas d’erreur possibles, consultez IotHubServiceErrorCode.

HttpRequestException

Si cette méthode a demandé à IoT Hub d’obtenir la page suivante des éléments, mais que la requête HTTP échoue en raison d’un problème sous-jacent tel que la connectivité réseau, l’échec DNS ou la validation du certificat de serveur.

OperationCanceledException

Si le jeton d’annulation fourni a demandé l’annulation.

Exemples


   QueryResponse<Twin> queriedTwins = await iotHubServiceClient.Query.CreateAsync<Twin>("SELECT * FROM devices");
   while (await queriedTwins.MoveNextAsync())
   {
       Twin queriedTwin = queriedTwins.Current;
       Console.WriteLine(queriedTwin);
   }

Remarques

Comme avec une implémentation plus classique d’IEnumerator, cette fonction doit être appelée une fois avant de vérifier Current.

Cette fonction est asynchrone, car elle peut faire une demande de service pour extraire la page suivante des résultats si la page active des résultats a déjà été avancée. Notez que cette fonction retourne True même si elle se trouve à la fin d’une page particulière d’éléments tant qu’il y a au moins une page supplémentaire à extraire.

S’applique à

Partager via