Query クラス

定義

名前空間:

Microsoft.Azure.Devices.Provisioning.Service

アセンブリ:

Microsoft.Azure.Devices.Provisioning.Service.dll

パッケージ:

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

クエリ反復子。

public class Query : IDisposable

type Query = class
    interface IDisposable

Public Class Query
Implements IDisposable

継承

Object

Query

実装

IDisposable

注釈

反復子は Query 、 のクエリ ファクトリの結果です。

• IndividualEnrollment
• EnrollmentGroup
• RegistrationStatus

すべてのケースで、 QuerySpecification には、Device Provisioning Service のクエリ言語に従う必要がある SQL クエリが含まれています。

必要に応じて、ページ サイズを持つ Integer で、 によって返される 内の QueryResult 項目の最大数を NextAsync()決定できます。 正の整数である必要があり、0 が含まれている場合、Device Provisioning Service はそれを無視し、標準のページ サイズを使用します。

このオブジェクトは、ループ内で while と NextAsync を使用するだけで、 が false を含む時点HasNextまで、標準反復子として使用HasNextできます。 ただし、 が含まれている場合でも、 には空のリストをHasNext含trueめることができることにQueryResult注意してください。 たとえば、Device Provisioning Service に 10 個の IndividualEnrollment があり、 が 5 の新しいクエリを PageSize 作成した画像です。 最初のイテレーションでは、 HasNext に が含 trueまれており、最初 NextAsync の は 5 つの項目を持つ を QueryResult 返します。 その後、コードは をチェックHasNextします。このコードには true が再び含まれます。 次のページを取得する前に、だれかがすべての IndividualEnrollment を削除します。 何が起こったか、 を NextAsync呼び出すと、有効な QueryResultが返されますが、 Items には空のリストが含まれます。

に加 Itemsえて、 QueryResult には が ContinuationToken含まれています。 クエリ コンテキスト (QuerySpecification + ContinuationToken) を格納し、停止した時点から後で再起動することもできます。 同じものQuerySpecificationを使用してクエリを再作成し、格納されている ContinuationTokenを渡す をNextAsync(String)呼び出すだけです。

プロパティ

ContinuationToken	次のページを取得するトークン。
PageSize	現在のページ内のアイテムの数。

メソッド

Dispose()	HTTP リソースを破棄します。
Dispose(Boolean)	コンポーネントによって使用されるアンマネージド リソースを解放し、必要に応じてマネージド リソースを解放します。
HasNext()	の Getter は次のを持っています。
NextAsync()	クエリの結果の次のページを返します。
NextAsync(String)	新しい continuationToken を使用して、クエリの結果の次のページを返します。