QueryClient.CreateAsync<T> 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.

Exécutez une requête sur votre hub IoT et obtenez un ensemble itérable des éléments interrogés.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Devices.QueryResponse<T>> CreateAsync<T> (string query, Microsoft.Azure.Devices.QueryOptions options = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateAsync : string * Microsoft.Azure.Devices.QueryOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.QueryResponse<'T>>
override this.CreateAsync : string * Microsoft.Azure.Devices.QueryOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.QueryResponse<'T>>

Public Overridable Function CreateAsync(Of T) (query As String, Optional options As QueryOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of QueryResponse(Of T))

Paramètres de type

T

Type dans lequel désérialiser l’ensemble d’éléments. Par exemple, lors de l’exécution d’une requête telle que « SELECT * FROM devices », ce type doit être ClientTwin. Lors de l’exécution d’une requête telle que « SELECT * FROM devices.jobs », ce type doit être ScheduledJob.

Paramètres

query: String

Requête. Pour plus d’informations sur la création de cette requête, consultez ce document .

options: QueryOptions

Paramètres facultatifs pour exécuter la requête.

cancellationToken: CancellationToken

Jeton d’annulation de tâche.

Retours

Task<QueryResponse<T>>

Ensemble itérable des éléments interrogés.

Exceptions

ArgumentNullException

Lorsque le fourni query a la valeur Null.

ArgumentException

Si le fourni query est vide ou espace blanc.

IotHubServiceException

Si IoT Hub a répondu à la demande avec un code de 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 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);
  }


  QueryResponse<ScheduledJob> queriedJobs = await iotHubServiceClient.Query.CreateAsync<ScheduledJob>("SELECT * FROM devices.jobs");
  while (await queriedJobs.MoveNextAsync())
  {
      ScheduledJob queriedJob = queriedJobs.Current;
      Console.WriteLine(queriedJob);
  }

Remarques

Le type d’éléments itérables retournés par cette requête dépend de la requête fournie.

S’applique à

Partager via