Query Classe

Definição

Namespace:

Microsoft.Azure.Devices.Provisioning.Service

Assembly:

Microsoft.Azure.Devices.Provisioning.Service.dll

Pacote:

Microsoft.Azure.Devices.Provisioning.Service v1.18.1

O iterador de consulta.

public class Query : IDisposable

type Query = class
    interface IDisposable

Public Class Query
Implements IDisposable

Herança

Object

Query

Implementações

IDisposable

Comentários

O Query iterador é o resultado da fábrica de consultas para

• IndividualEnrollment
• EnrollmentGroup
• RegistrationStatus

Em todos os casos, o QuerySpecification contém uma consulta SQL que deve seguir a Linguagem de Consulta para o Serviço de Provisionamento de Dispositivos.

Opcionalmente, um Inteiro com o tamanho da página pode determinar o número máximo dos itens no QueryResult retornado pelo NextAsync(). Ele deve ser qualquer inteiro positivo e, se contiver 0, o Serviço de Provisionamento de Dispositivos o ignorará e usará um tamanho de página padrão.

Você pode usar esse Objeto como um iterador padrão, usando apenas o HasNext e em um while loop, até o ponto em que o HasNextNextAsync contém false. Porém, tenha em mente que o QueryResult pode conter uma lista vazia, mesmo se o HasNext contido true. Por exemplo, imagem que você tem 10 IndividualEnrollment no Serviço de Provisionamento de Dispositivos e criou uma nova consulta com o igual a PageSize 5. Na primeira iteração, HasNext conterá truee o primeiro NextAsync retornará um QueryResult com 5 itens. Depois disso, o código marcar o HasNext, que conterá true novamente. Agora, antes de obter a próxima página, alguém exclui todo o IndividualEnrollment. O que aconteceu, quando você chamar o NextAsync, ele retornará um válido QueryResult, mas o Items conterá uma lista vazia.

Além do Items, o QueryResult contém o ContinuationToken. Você também pode armazenar um contexto de consulta (QuerySpecification + ContinuationToken) e reiniciá-lo no futuro, a partir do ponto em que você parou. Basta recriar a consulta com o mesmo QuerySpecification e chamar o NextAsync(String) passando o armazenado ContinuationToken.

Propriedades

ContinuationToken	O token para recuperar a próxima página.
PageSize	O número de itens na página atual.

Métodos

Dispose()	Descarte os recursos HTTP.
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo Componente e, opcionalmente, libera os recursos gerenciados.
HasNext()	Getter para tem o próximo.
NextAsync()	Retornar a próxima página de resultado da consulta.
NextAsync(String)	Retornar a próxima página de resultado da consulta usando um novo continuationToken.