Query Klasse

Definition

Namespace:

Microsoft.Azure.Devices.Provisioning.Service

Assembly:

Microsoft.Azure.Devices.Provisioning.Service.dll

Paket:

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

Der Abfrage-Iterator.

public class Query : IDisposable

type Query = class
    interface IDisposable

Public Class Query
Implements IDisposable

Vererbung

Object

Query

Implementiert

IDisposable

Hinweise

Der Query Iterator ist das Ergebnis der Abfragefactory für

• IndividualEnrollment
• EnrollmentGroup
• RegistrationStatus

In allen Fällen enthält die QuerySpecification eine SQL-Abfrage, die der Abfragesprache für den Gerätebereitstellungsdienst folgen muss.

Optional kann eine ganzzahlige Zahl mit der Seitengröße die maximale Anzahl der Elemente in der bestimmen, die QueryResult von zurückgegeben wird NextAsync(). Es muss eine beliebige positive ganze Zahl sein, und wenn sie 0 enthält, ignoriert der Gerätebereitstellungsdienst sie und verwendet eine Standardseitengröße.

Sie können dieses Objekt als Standard-Iterator verwenden, indem Sie einfach das HasNext und in einer while Schleife verwenden, bis zu dem Punkt, an dem false HasNextNextAsync enthält. Beachten Sie jedoch, dass die QueryResult eine leere Liste enthalten kann, auch wenn die HasNext enthalten ist true. Beispiel: Abbildung, dass Sie über 10 IndividualEnrollment im Device Provisioning Service verfügen und eine neue Abfrage mit dem PageSize wert 5 erstellt haben. In der ersten Iteration HasNext enthält true, und die erste NextAsync gibt ein QueryResult mit 5 Elementen zurück. Danach überprüft Ihr Code den , der HasNexterneut "true" enthält. Bevor Sie nun die nächste Seite erhalten, löscht jemand die gesamte IndividualEnrollment-Datei. Was passiert ist, wenn Sie den NextAsyncaufrufen, wird eine gültige QueryResultzurückgegeben, die jedoch Items eine leere Liste enthält.

Neben enthält Itemsdas QueryResult das ContinuationToken. Sie können auch einen Abfragekontext (QuerySpecification + ContinuationToken) speichern und von dem Zeitpunkt an, an dem Sie angehalten haben, in Zukunft neu starten. Erstellen Sie einfach die Abfrage mit demselben QuerySpecification erneut, und rufen Sie das NextAsync(String) übergebene gespeicherte ContinuationTokenauf.

Eigenschaften

ContinuationToken	Das Token zum Abrufen der nächsten Seite.
PageSize	Die Anzahl der Elemente auf der aktuellen Seite.

Methoden

Dispose()	Entsorgen Sie die HTTP-Ressourcen.
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von der Komponente verwendet werden, und gibt optional die verwalteten Ressourcen frei.
HasNext()	Getter für hat Den nächsten.
NextAsync()	Gibt die nächste Seite des Ergebnisses für die Abfrage zurück.
NextAsync(String)	Gibt die nächste Ergebnisseite für die Abfrage mit einem neuen continuationToken zurück.