Query Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
O iterador de consulta.
public class Query : IDisposable
public class Query
type Query = class
interface IDisposable
type Query = class
Public Class Query
Implements IDisposable
Public Class Query
- Herança
-
Query
- Implementações
Comentários
O Query iterador é o resultado da fábrica de consultas para
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 HasNext
NextAsync
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á true
e 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. |
Aplica-se a
Azure SDK for .NET