DocumentClient.CreateDocumentQuery メソッド

定義

オーバーロード

CreateDocumentQuery(String, SqlQuerySpec, FeedOptions, Object)
古い.

オーバーロードされます。 このメソッドは、パラメーター化された値を持つ SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{dynamic} を返します。 パラメーター化された値を使用した SQL ステートメントの準備の詳細については、 を参照してください SqlQuerySpec

CreateDocumentQuery(String, String, FeedOptions, Object)
古い.

オーバーロードされます。 このメソッドは、SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{dynamic} を返します。

CreateDocumentQuery(Uri, String, FeedOptions)

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

CreateDocumentQuery(Uri, String, FeedOptions, Object)
古い.

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

CreateDocumentQuery(Uri, SqlQuerySpec, FeedOptions, Object)
古い.

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

CreateDocumentQuery(Uri, SqlQuerySpec, FeedOptions)

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

CreateDocumentQuery(String, String, FeedOptions)

オーバーロードされます。 このメソッドは、SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{dynamic} を返します。

CreateDocumentQuery(String, SqlQuerySpec, FeedOptions)

オーバーロードされます。 このメソッドは、パラメーター化された値を持つ SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{dynamic} を返します。 パラメーター化された値を使用した SQL ステートメントの準備の詳細については、 を参照してください SqlQuerySpec

CreateDocumentQuery(String, FeedOptions, Object)
古い.

オーバーロードされます。 このメソッドは、Azure Cosmos DB サービスのコレクションの下にドキュメントのクエリを作成します。 IOrderedQueryable{Document} を返します。

CreateDocumentQuery(Uri, FeedOptions)

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

CreateDocumentQuery(String, FeedOptions)

オーバーロードされます。 このメソッドは、Azure Cosmos DB サービスのコレクションの下にドキュメントのクエリを作成します。 IOrderedQueryable{Document} を返します。

CreateDocumentQuery(Uri, FeedOptions, Object)
古い.

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

CreateDocumentQuery<T>(Uri, SqlQuerySpec, FeedOptions)

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

CreateDocumentQuery<T>(Uri, String, FeedOptions, Object)
古い.

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

CreateDocumentQuery<T>(Uri, SqlQuerySpec, FeedOptions, Object)
古い.

Azure Cosmos DB サービスのドキュメントのクエリを作成する拡張メソッド。

CreateDocumentQuery<T>(String, String, FeedOptions, Object)
古い.

オーバーロードされます。 このメソッドは、SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{T} を返します。

CreateDocumentQuery<T>(String, SqlQuerySpec, FeedOptions, Object)
古い.

オーバーロードされます。 このメソッドは、パラメーター化された値を持つ SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{T} を返します。 パラメーター化された値を使用した SQL ステートメントの準備の詳細については、 を参照してください SqlQuerySpec

CreateDocumentQuery<T>(Uri, String, FeedOptions)

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

CreateDocumentQuery<T>(Uri, FeedOptions, Object)
古い.

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

CreateDocumentQuery<T>(String, String, FeedOptions)

オーバーロードされます。 このメソッドは、SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{T} を返します。

CreateDocumentQuery<T>(String, SqlQuerySpec, FeedOptions)

オーバーロードされます。 このメソッドは、パラメーター化された値を持つ SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{T} を返します。 パラメーター化された値を使用した SQL ステートメントの準備の詳細については、 を参照してください SqlQuerySpec

CreateDocumentQuery<T>(String, FeedOptions, Object)
古い.

オーバーロードされます。 このメソッドは、Azure Cosmos DB サービスのコレクションの下にドキュメントのクエリを作成します。

CreateDocumentQuery<T>(Uri, FeedOptions)

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

CreateDocumentQuery<T>(String, FeedOptions)

オーバーロードされます。 このメソッドは、Azure Cosmos DB サービスのコレクションの下にドキュメントのクエリを作成します。

CreateDocumentQuery(String, SqlQuerySpec, FeedOptions, Object)

注意事項

Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.

オーバーロードされます。 このメソッドは、パラメーター化された値を持つ SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{dynamic} が返されます。 パラメーター化された値を使用した SQL ステートメントの準備の詳細については、 を参照してください SqlQuerySpec

[System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")]
public System.Linq.IQueryable<dynamic> CreateDocumentQuery (string collectionLink, Microsoft.Azure.Documents.SqlQuerySpec querySpec, Microsoft.Azure.Documents.Client.FeedOptions feedOptions, object partitionKey);
[<System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")>]
member this.CreateDocumentQuery : string * Microsoft.Azure.Documents.SqlQuerySpec * Microsoft.Azure.Documents.Client.FeedOptions * obj -> System.Linq.IQueryable<obj>
Public Function CreateDocumentQuery (collectionLink As String, querySpec As SqlQuerySpec, feedOptions As FeedOptions, partitionKey As Object) As IQueryable(Of Object)

パラメーター

collectionLink
String

親ドキュメント コレクションへのリンク。 または、IPartitionResolver を使用する場合は、データベースへのパス リンク (dbs/db_rid/ など) を指定することもできます。

querySpec
SqlQuerySpec

SQL 式を含む SqlQuerySpec インスタンス。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。 詳細については、FeedOptions を参照してください

partitionKey
Object

IPartitionResolver で使用できるパーティション キー。

戻り値

クエリを評価できる IQueryable{dynamic> 。

属性

注釈

IPartitionResolver ベースのメソッド オーバーロードのサポートは廃止されました。 より高いストレージとスループットを実現するために 、パーティション分割コレクションを 使用することをお勧めします。

適用対象

CreateDocumentQuery(String, String, FeedOptions, Object)

注意事項

Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.

オーバーロードされます。 このメソッドは、SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{dynamic} が返されます。

[System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")]
public System.Linq.IQueryable<dynamic> CreateDocumentQuery (string collectionLink, string sqlExpression, Microsoft.Azure.Documents.Client.FeedOptions feedOptions, object partitionKey);
[<System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")>]
member this.CreateDocumentQuery : string * string * Microsoft.Azure.Documents.Client.FeedOptions * obj -> System.Linq.IQueryable<obj>
Public Function CreateDocumentQuery (collectionLink As String, sqlExpression As String, feedOptions As FeedOptions, partitionKey As Object) As IQueryable(Of Object)

パラメーター

collectionLink
String

親ドキュメント コレクションのリンク。 または、IPartitionResolver を使用する場合は、データベースへのパス リンク (dbs/db_rid/ など) を指定することもできます。

sqlExpression
String

SQL ステートメント。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。 詳細については、FeedOptions を参照してください

partitionKey
Object

IPartitionResolver で使用できるパーティション キー。

戻り値

クエリを評価できる IQueryable{dynamic> 。

属性

注釈

IPartitionResolver ベースのメソッド オーバーロードのサポートは廃止されました。 より高いストレージとスループットを実現するために 、パーティション分割コレクションを 使用することをお勧めします。

適用対象

CreateDocumentQuery(Uri, String, FeedOptions)

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

public System.Linq.IQueryable<dynamic> CreateDocumentQuery (Uri documentCollectionOrDatabaseUri, string sqlExpression, Microsoft.Azure.Documents.Client.FeedOptions feedOptions = default);
abstract member CreateDocumentQuery : Uri * string * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<obj>
override this.CreateDocumentQuery : Uri * string * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<obj>
Public Function CreateDocumentQuery (documentCollectionOrDatabaseUri As Uri, sqlExpression As String, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of Object)

パラメーター

documentCollectionOrDatabaseUri
Uri

ドキュメント コレクションの URI。

sqlExpression
String

SQL クエリ。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。

戻り値

クエリ結果セット。

実装

適用対象

CreateDocumentQuery(Uri, String, FeedOptions, Object)

注意事項

Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

[System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")]
public System.Linq.IQueryable<dynamic> CreateDocumentQuery (Uri documentCollectionOrDatabaseUri, string sqlExpression, Microsoft.Azure.Documents.Client.FeedOptions feedOptions, object partitionKey);
[<System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")>]
member this.CreateDocumentQuery : Uri * string * Microsoft.Azure.Documents.Client.FeedOptions * obj -> System.Linq.IQueryable<obj>
Public Function CreateDocumentQuery (documentCollectionOrDatabaseUri As Uri, sqlExpression As String, feedOptions As FeedOptions, partitionKey As Object) As IQueryable(Of Object)

パラメーター

documentCollectionOrDatabaseUri
Uri

ドキュメント コレクションの URI (例: dbs/db_rid/colls/coll_rid/)。 または、dbs/db_rid/ などの を使用 IPartitionResolverする場合は、データベースの URI にすることができます。

sqlExpression
String

SQL クエリ。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。

partitionKey
Object

IPartitionResolver で使用できるパーティション キー。

戻り値

クエリ結果セット。

属性

注釈

IPartitionResolver ベースのメソッド オーバーロードのサポートは廃止されました。 より高いストレージとスループットを実現するために 、パーティション分割コレクションを 使用することをお勧めします。

適用対象

CreateDocumentQuery(Uri, SqlQuerySpec, FeedOptions, Object)

注意事項

Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

[System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")]
public System.Linq.IQueryable<dynamic> CreateDocumentQuery (Uri documentCollectionOrDatabaseUri, Microsoft.Azure.Documents.SqlQuerySpec querySpec, Microsoft.Azure.Documents.Client.FeedOptions feedOptions, object partitionKey);
[<System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")>]
member this.CreateDocumentQuery : Uri * Microsoft.Azure.Documents.SqlQuerySpec * Microsoft.Azure.Documents.Client.FeedOptions * obj -> System.Linq.IQueryable<obj>
Public Function CreateDocumentQuery (documentCollectionOrDatabaseUri As Uri, querySpec As SqlQuerySpec, feedOptions As FeedOptions, partitionKey As Object) As IQueryable(Of Object)

パラメーター

documentCollectionOrDatabaseUri
Uri

ドキュメント コレクションの URI (例: dbs/db_rid/colls/coll_rid/)。 または、dbs/db_rid/ などの を使用 IPartitionResolverする場合は、データベースの URI にすることができます。

querySpec
SqlQuerySpec

SQL クエリ。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。

partitionKey
Object

IPartitionResolver で使用できるパーティション キー。

戻り値

クエリ結果セット。

属性

注釈

IPartitionResolver ベースのメソッド オーバーロードのサポートは廃止されました。 より高いストレージとスループットを実現するために 、パーティション分割コレクションを 使用することをお勧めします。

適用対象

CreateDocumentQuery(Uri, SqlQuerySpec, FeedOptions)

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

public System.Linq.IQueryable<dynamic> CreateDocumentQuery (Uri documentCollectionOrDatabaseUri, Microsoft.Azure.Documents.SqlQuerySpec querySpec, Microsoft.Azure.Documents.Client.FeedOptions feedOptions = default);
abstract member CreateDocumentQuery : Uri * Microsoft.Azure.Documents.SqlQuerySpec * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<obj>
override this.CreateDocumentQuery : Uri * Microsoft.Azure.Documents.SqlQuerySpec * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<obj>
Public Function CreateDocumentQuery (documentCollectionOrDatabaseUri As Uri, querySpec As SqlQuerySpec, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of Object)

パラメーター

documentCollectionOrDatabaseUri
Uri

ドキュメント コレクションの URI。

querySpec
SqlQuerySpec

SQL クエリ。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。

戻り値

クエリ結果セット。

実装

適用対象

CreateDocumentQuery(String, String, FeedOptions)

オーバーロードされます。 このメソッドは、SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{dynamic} が返されます。

public System.Linq.IQueryable<dynamic> CreateDocumentQuery (string collectionLink, string sqlExpression, Microsoft.Azure.Documents.Client.FeedOptions feedOptions = default);
abstract member CreateDocumentQuery : string * string * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<obj>
override this.CreateDocumentQuery : string * string * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<obj>
Public Function CreateDocumentQuery (collectionLink As String, sqlExpression As String, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of Object)

パラメーター

collectionLink
String

親ドキュメント コレクションへのリンク。

sqlExpression
String

SQL ステートメント。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。 詳細については、FeedOptions を参照してください

戻り値

クエリを評価できる IQueryable{dynamic> 。

実装

次の例では、書籍ドキュメントのクエリを実行します。

// SQL querying allows dynamic property access
dynamic document = client.CreateDocumentQuery<dynamic>(collectionLink,
    "SELECT * FROM books b WHERE b.title == 'War and Peace'").AsEnumerable().FirstOrDefault();

注釈

構文と例については、 https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started/ を参照してください。

こちらもご覧ください

適用対象

CreateDocumentQuery(String, SqlQuerySpec, FeedOptions)

オーバーロードされます。 このメソッドは、パラメーター化された値を持つ SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{dynamic} が返されます。 パラメーター化された値を使用した SQL ステートメントの準備の詳細については、 を参照してください SqlQuerySpec

public System.Linq.IQueryable<dynamic> CreateDocumentQuery (string collectionLink, Microsoft.Azure.Documents.SqlQuerySpec querySpec, Microsoft.Azure.Documents.Client.FeedOptions feedOptions = default);
abstract member CreateDocumentQuery : string * Microsoft.Azure.Documents.SqlQuerySpec * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<obj>
override this.CreateDocumentQuery : string * Microsoft.Azure.Documents.SqlQuerySpec * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<obj>
Public Function CreateDocumentQuery (collectionLink As String, querySpec As SqlQuerySpec, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of Object)

パラメーター

collectionLink
String

親ドキュメント コレクションへのリンク。

querySpec
SqlQuerySpec

SQL 式を含む SqlQuerySpec インスタンス。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。 詳細については、FeedOptions を参照してください

戻り値

クエリを評価できる IQueryable{dynamic> 。

実装

次の例では、書籍ドキュメントのクエリを実行します。

// SQL querying allows dynamic property access
var query = new SqlQuerySpec(
    "SELECT * FROM books b WHERE b.title = @title", 
    new SqlParameterCollection(new SqlParameter[] { new SqlParameter { Name = "@title", Value = "War and Peace" }}));

dynamic document = client.CreateDocumentQuery<dynamic>(collectionLink, query).AsEnumerable().FirstOrDefault();

注釈

構文と例については、 https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started/ を参照してください。

こちらもご覧ください

適用対象

CreateDocumentQuery(String, FeedOptions, Object)

注意事項

Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.

オーバーロードされます。 このメソッドは、Azure Cosmos DB サービスのコレクションの下にドキュメントのクエリを作成します。 IOrderedQueryable{Document} を返します。

[System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")]
public System.Linq.IOrderedQueryable<Microsoft.Azure.Documents.Document> CreateDocumentQuery (string collectionLink, Microsoft.Azure.Documents.Client.FeedOptions feedOptions, object partitionKey);
[<System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")>]
member this.CreateDocumentQuery : string * Microsoft.Azure.Documents.Client.FeedOptions * obj -> System.Linq.IOrderedQueryable<Microsoft.Azure.Documents.Document>
Public Function CreateDocumentQuery (collectionLink As String, feedOptions As FeedOptions, partitionKey As Object) As IOrderedQueryable(Of Document)

パラメーター

collectionLink
String

親ドキュメント コレクションへのリンク。 または、IPartitionResolver を使用する場合は、データベースへのパス リンクを指定することもできます。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。 詳細については、FeedOptions を参照してください

partitionKey
Object

IPartitionResolver で使用できるオプションのパーティション キー。

戻り値

クエリを評価できる IOrderedQueryable{Document}。

属性

注釈

IPartitionResolver ベースのメソッド オーバーロードのサポートは廃止されました。 より高いストレージとスループットを実現するために 、パーティション分割コレクションを 使用することをお勧めします。

適用対象

CreateDocumentQuery(Uri, FeedOptions)

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

public System.Linq.IOrderedQueryable<Microsoft.Azure.Documents.Document> CreateDocumentQuery (Uri documentCollectionOrDatabaseUri, Microsoft.Azure.Documents.Client.FeedOptions feedOptions = default);
abstract member CreateDocumentQuery : Uri * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IOrderedQueryable<Microsoft.Azure.Documents.Document>
override this.CreateDocumentQuery : Uri * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IOrderedQueryable<Microsoft.Azure.Documents.Document>
Public Function CreateDocumentQuery (documentCollectionOrDatabaseUri As Uri, Optional feedOptions As FeedOptions = Nothing) As IOrderedQueryable(Of Document)

パラメーター

documentCollectionOrDatabaseUri
Uri

ドキュメント コレクションの URI。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。

戻り値

クエリ結果セット。

実装

適用対象

CreateDocumentQuery(String, FeedOptions)

オーバーロードされます。 このメソッドは、Azure Cosmos DB サービスのコレクションの下にドキュメントのクエリを作成します。 IOrderedQueryable{Document} を返します。

public System.Linq.IOrderedQueryable<Microsoft.Azure.Documents.Document> CreateDocumentQuery (string collectionLink, Microsoft.Azure.Documents.Client.FeedOptions feedOptions = default);
abstract member CreateDocumentQuery : string * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IOrderedQueryable<Microsoft.Azure.Documents.Document>
override this.CreateDocumentQuery : string * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IOrderedQueryable<Microsoft.Azure.Documents.Document>
Public Function CreateDocumentQuery (collectionLink As String, Optional feedOptions As FeedOptions = Nothing) As IOrderedQueryable(Of Document)

パラメーター

collectionLink
String

親ドキュメント コレクションへのリンク。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。 詳細については、FeedOptions を参照してください

戻り値

クエリを評価できる IOrderedQueryable{Document}。

実装

次の例では、ID によるドキュメントのクエリを実行します。

Document document = client.CreateDocumentQuery<Document>(collectionLink)
    .Where(d => d.Id == "War and Peace").AsEnumerable().FirstOrDefault();

注釈

このオーバーロードは、クエリ対象のドキュメントのスキーマが不明な場合、または ID を使用してクエリを実行し、ドキュメントを置換または削除する場合に使用する必要があります。 Document は DynamicObject であるため、元の C# オブジェクトに動的にキャストバックできます。

こちらもご覧ください

適用対象

CreateDocumentQuery(Uri, FeedOptions, Object)

注意事項

Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

[System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")]
public System.Linq.IOrderedQueryable<Microsoft.Azure.Documents.Document> CreateDocumentQuery (Uri documentCollectionOrDatabaseUri, Microsoft.Azure.Documents.Client.FeedOptions feedOptions, object partitionKey);
[<System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")>]
member this.CreateDocumentQuery : Uri * Microsoft.Azure.Documents.Client.FeedOptions * obj -> System.Linq.IOrderedQueryable<Microsoft.Azure.Documents.Document>
Public Function CreateDocumentQuery (documentCollectionOrDatabaseUri As Uri, feedOptions As FeedOptions, partitionKey As Object) As IOrderedQueryable(Of Document)

パラメーター

documentCollectionOrDatabaseUri
Uri

ドキュメント コレクションの URI (dbs/db_rid/colls/coll_rid/ など)。 または、dbs/db_rid/ などの を使用 IPartitionResolverする場合は、データベースの URI を指定することもできます。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。

partitionKey
Object

IPartitionResolver で使用できるパーティション キー。

戻り値

クエリ結果セット。

属性

注釈

IPartitionResolver ベースのメソッド オーバーロードのサポートは廃止されました。 より高いストレージとスループットを実現するために 、パーティション分割コレクションを 使用することをお勧めします。

適用対象

CreateDocumentQuery<T>(Uri, SqlQuerySpec, FeedOptions)

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

public System.Linq.IQueryable<T> CreateDocumentQuery<T> (Uri documentCollectionOrDatabaseUri, Microsoft.Azure.Documents.SqlQuerySpec querySpec, Microsoft.Azure.Documents.Client.FeedOptions feedOptions = default);
abstract member CreateDocumentQuery : Uri * Microsoft.Azure.Documents.SqlQuerySpec * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<'T>
override this.CreateDocumentQuery : Uri * Microsoft.Azure.Documents.SqlQuerySpec * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<'T>
Public Function CreateDocumentQuery(Of T) (documentCollectionOrDatabaseUri As Uri, querySpec As SqlQuerySpec, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of T)

型パラメーター

T

クエリを実行するオブジェクトの型。

パラメーター

documentCollectionOrDatabaseUri
Uri

ドキュメント コレクションの URI。

querySpec
SqlQuerySpec

sql クエリ。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。

戻り値

クエリ結果セット。

実装

適用対象

CreateDocumentQuery<T>(Uri, String, FeedOptions, Object)

注意事項

Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

[System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")]
public System.Linq.IQueryable<T> CreateDocumentQuery<T> (Uri documentCollectionOrDatabaseUri, string sqlExpression, Microsoft.Azure.Documents.Client.FeedOptions feedOptions, object partitionKey);
[<System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")>]
member this.CreateDocumentQuery : Uri * string * Microsoft.Azure.Documents.Client.FeedOptions * obj -> System.Linq.IQueryable<'T>
Public Function CreateDocumentQuery(Of T) (documentCollectionOrDatabaseUri As Uri, sqlExpression As String, feedOptions As FeedOptions, partitionKey As Object) As IQueryable(Of T)

型パラメーター

T

クエリを実行するオブジェクトの型。

パラメーター

documentCollectionOrDatabaseUri
Uri

ドキュメント コレクションの URI (dbs/db_rid/colls/coll_rid/ など)。 または、dbs/db_rid/ などの を使用 IPartitionResolverする場合は、データベースの URI を指定することもできます。

sqlExpression
String

sql クエリ。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。

partitionKey
Object

IPartitionResolver で使用できるパーティション キー。

戻り値

クエリ結果セット。

属性

注釈

IPartitionResolver ベースのメソッド オーバーロードのサポートは廃止されました。 より高いストレージとスループットを実現するために 、パーティション分割コレクションを 使用することをお勧めします。

適用対象

CreateDocumentQuery<T>(Uri, SqlQuerySpec, FeedOptions, Object)

注意事項

Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.

Azure Cosmos DB サービスのドキュメントのクエリを作成する拡張メソッド。

[System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")]
public System.Linq.IQueryable<T> CreateDocumentQuery<T> (Uri documentCollectionOrDatabaseUri, Microsoft.Azure.Documents.SqlQuerySpec querySpec, Microsoft.Azure.Documents.Client.FeedOptions feedOptions, object partitionKey);
[<System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")>]
member this.CreateDocumentQuery : Uri * Microsoft.Azure.Documents.SqlQuerySpec * Microsoft.Azure.Documents.Client.FeedOptions * obj -> System.Linq.IQueryable<'T>
Public Function CreateDocumentQuery(Of T) (documentCollectionOrDatabaseUri As Uri, querySpec As SqlQuerySpec, feedOptions As FeedOptions, partitionKey As Object) As IQueryable(Of T)

型パラメーター

T

クエリを実行するオブジェクトの型。

パラメーター

documentCollectionOrDatabaseUri
Uri

ドキュメント コレクションの URI (dbs/db_rid/colls/coll_rid/ など)。 または、dbs/db_rid/ などの を使用 IPartitionResolverする場合は、データベースの URI を指定することもできます。

querySpec
SqlQuerySpec

sql クエリ。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。

partitionKey
Object

IPartitionResolver で使用できるパーティション キー。

戻り値

クエリ結果セット。

属性

注釈

IPartitionResolver ベースのメソッド オーバーロードのサポートは廃止されました。 より高いストレージとスループットを実現するために 、パーティション分割コレクションを 使用することをお勧めします。

適用対象

CreateDocumentQuery<T>(String, String, FeedOptions, Object)

注意事項

Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.

オーバーロードされます。 このメソッドは、SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{T} を返します。

[System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")]
public System.Linq.IQueryable<T> CreateDocumentQuery<T> (string collectionLink, string sqlExpression, Microsoft.Azure.Documents.Client.FeedOptions feedOptions, object partitionKey);
[<System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")>]
member this.CreateDocumentQuery : string * string * Microsoft.Azure.Documents.Client.FeedOptions * obj -> System.Linq.IQueryable<'T>
Public Function CreateDocumentQuery(Of T) (collectionLink As String, sqlExpression As String, feedOptions As FeedOptions, partitionKey As Object) As IQueryable(Of T)

型パラメーター

T

クエリを実行するオブジェクトの型。

パラメーター

collectionLink
String

コレクションの下にあるドキュメントのパス リンク (dbs/db_rid/colls/coll_rid/docs/ など)。 または、IPartitionResolver (dbs/db_rid/ など) を使用する場合は、データベースへのパス リンクを指定することもできます。

sqlExpression
String

SQL ステートメント。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。 詳細については、FeedOptions を参照してください

partitionKey
Object

IPartitionResolver で使用できるパーティション キー。

戻り値

クエリを評価できる IQueryable{T}。

属性

注釈

IPartitionResolver ベースのメソッド オーバーロードのサポートは廃止されました。 より高いストレージとスループットを実現するために 、パーティション分割コレクションを 使用することをお勧めします。

適用対象

CreateDocumentQuery<T>(String, SqlQuerySpec, FeedOptions, Object)

注意事項

Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.

オーバーロードされます。 このメソッドは、パラメーター化された値を持つ SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{T} を返します。 パラメーター化された値を使用した SQL ステートメントの準備の詳細については、 を参照してください SqlQuerySpec

[System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")]
public System.Linq.IQueryable<T> CreateDocumentQuery<T> (string collectionLink, Microsoft.Azure.Documents.SqlQuerySpec querySpec, Microsoft.Azure.Documents.Client.FeedOptions feedOptions, object partitionKey);
[<System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")>]
member this.CreateDocumentQuery : string * Microsoft.Azure.Documents.SqlQuerySpec * Microsoft.Azure.Documents.Client.FeedOptions * obj -> System.Linq.IQueryable<'T>
Public Function CreateDocumentQuery(Of T) (collectionLink As String, querySpec As SqlQuerySpec, feedOptions As FeedOptions, partitionKey As Object) As IQueryable(Of T)

型パラメーター

T

クエリを実行するオブジェクトの型。

パラメーター

collectionLink
String

親ドキュメント コレクションへのリンク。 または、IPartitionResolver を使用する場合は、データベースへのパス リンクを指定することもできます。

querySpec
SqlQuerySpec

SQL 式を含む SqlQuerySpec インスタンス。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。 詳細については、FeedOptions を参照してください

partitionKey
Object

IPartitionResolver で使用できるパーティション キー。

戻り値

クエリを評価できる IQueryable{T}。

属性

注釈

IPartitionResolver ベースのメソッド オーバーロードのサポートは廃止されました。 より高いストレージとスループットを実現するために 、パーティション分割コレクションを 使用することをお勧めします。

適用対象

CreateDocumentQuery<T>(Uri, String, FeedOptions)

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

public System.Linq.IQueryable<T> CreateDocumentQuery<T> (Uri documentCollectionOrDatabaseUri, string sqlExpression, Microsoft.Azure.Documents.Client.FeedOptions feedOptions = default);
abstract member CreateDocumentQuery : Uri * string * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<'T>
override this.CreateDocumentQuery : Uri * string * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<'T>
Public Function CreateDocumentQuery(Of T) (documentCollectionOrDatabaseUri As Uri, sqlExpression As String, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of T)

型パラメーター

T

クエリを実行するオブジェクトの型。

パラメーター

documentCollectionOrDatabaseUri
Uri

ドキュメント コレクションの URI。

sqlExpression
String

sql クエリ。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。

戻り値

クエリ結果セット。

実装

適用対象

CreateDocumentQuery<T>(Uri, FeedOptions, Object)

注意事項

Support for IPartitionResolver based method overloads is now obsolete. Please use the override that does not take a partitionKey parameter.

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

[System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. Please use the override that does not take a partitionKey parameter.")]
public System.Linq.IOrderedQueryable<T> CreateDocumentQuery<T> (Uri documentCollectionOrDatabaseUri, Microsoft.Azure.Documents.Client.FeedOptions feedOptions, object partitionKey);
[<System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. Please use the override that does not take a partitionKey parameter.")>]
member this.CreateDocumentQuery : Uri * Microsoft.Azure.Documents.Client.FeedOptions * obj -> System.Linq.IOrderedQueryable<'T>
Public Function CreateDocumentQuery(Of T) (documentCollectionOrDatabaseUri As Uri, feedOptions As FeedOptions, partitionKey As Object) As IOrderedQueryable(Of T)

型パラメーター

T

クエリを実行するオブジェクトの型。

パラメーター

documentCollectionOrDatabaseUri
Uri

ドキュメント コレクションの URI (dbs/db_rid/colls/coll_rid/ など)。 または、dbs/db_rid/ などの を使用 IPartitionResolverする場合は、データベースの URI を指定することもできます。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。

partitionKey
Object

IPartitionResolver で使用できるパーティション キー。

戻り値

クエリ結果セット。

属性

注釈

IPartitionResolver ベースのメソッド オーバーロードのサポートは廃止されました。 より高いストレージとスループットを実現するために 、パーティション分割コレクションを 使用することをお勧めします。

適用対象

CreateDocumentQuery<T>(String, String, FeedOptions)

オーバーロードされます。 このメソッドは、SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{T} を返します。

public System.Linq.IQueryable<T> CreateDocumentQuery<T> (string collectionLink, string sqlExpression, Microsoft.Azure.Documents.Client.FeedOptions feedOptions = default);
abstract member CreateDocumentQuery : string * string * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<'T>
override this.CreateDocumentQuery : string * string * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<'T>
Public Function CreateDocumentQuery(Of T) (collectionLink As String, sqlExpression As String, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of T)

型パラメーター

T

クエリを実行するオブジェクトの型。

パラメーター

collectionLink
String

親コレクションへのリンク。

sqlExpression
String

SQL ステートメント。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。 詳細については、FeedOptions を参照してください

戻り値

クエリを評価できる IQueryable{T}。

実装

次の例では、一部の書籍ドキュメントのクエリを実行します。

public class Book 
{
    [JsonProperty("title")]
    public string Title {get; set;}

    public Author Author {get; set;}

    public int Price {get; set;}
}

public class Author
{
    public string FirstName {get; set;}
    public string LastName {get; set;}
}

// Query by the Title property
Book book = client.CreateDocumentQuery<Book>(collectionLink, 
    "SELECT * FROM books b WHERE b.title  = 'War and Peace'").AsEnumerable().FirstOrDefault();

// Query a nested property
Book otherBook = client.CreateDocumentQuery<Book>(collectionLink,
    "SELECT * FROM books b WHERE b.Author.FirstName = 'Leo'").AsEnumerable().FirstOrDefault();

// Perform a range query (needs an IndexType.Range on price or FeedOptions.EnableScansInQuery)
foreach (Book matchingBook in client.CreateDocumentQuery<Book>(
    collectionLink, "SELECT * FROM books b where b.Price > 1000"))
{
    // Iterate through books
}

// Query asychronously. Optionally set FeedOptions.MaxItemCount to control page size
using (var queryable = client.CreateDocumentQuery<Book>(collectionLink, 
    "SELECT * FROM books b WHERE b.title  = 'War and Peace'", 
    new FeedOptions { MaxItemCount = 10 }).AsDocumentQuery())
{
    while (queryable.HasMoreResults) 
    {
        foreach(Book b in await queryable.ExecuteNextAsync<Book>())
        {
            // Iterate through books
        }
    }
}

注釈

構文と例については、 を https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started/ 参照してください。

こちらもご覧ください

適用対象

CreateDocumentQuery<T>(String, SqlQuerySpec, FeedOptions)

オーバーロードされます。 このメソッドは、パラメーター化された値を持つ SQL ステートメントを使用して、Azure Cosmos DB データベース内のコレクションの下にドキュメントのクエリを作成します。 IQueryable{T} を返します。 パラメーター化された値を使用した SQL ステートメントの準備の詳細については、 を参照してください SqlQuerySpec

public System.Linq.IQueryable<T> CreateDocumentQuery<T> (string collectionLink, Microsoft.Azure.Documents.SqlQuerySpec querySpec, Microsoft.Azure.Documents.Client.FeedOptions feedOptions = default);
abstract member CreateDocumentQuery : string * Microsoft.Azure.Documents.SqlQuerySpec * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<'T>
override this.CreateDocumentQuery : string * Microsoft.Azure.Documents.SqlQuerySpec * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<'T>
Public Function CreateDocumentQuery(Of T) (collectionLink As String, querySpec As SqlQuerySpec, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of T)

型パラメーター

T

クエリを実行するオブジェクトの型。

パラメーター

collectionLink
String

親ドキュメント コレクションへのリンク。

querySpec
SqlQuerySpec

SQL 式を含む SqlQuerySpec インスタンス。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。 詳細については、FeedOptions を参照してください

戻り値

クエリを評価できる IQueryable{T}。

実装

次の例では、一部の書籍ドキュメントのクエリを実行します。

public class Book 
{
    [JsonProperty("title")]
    public string Title {get; set;}

    public Author Author {get; set;}

    public int Price {get; set;}
}

public class Author
{
    public string FirstName {get; set;}
    public string LastName {get; set;}
}

// Query using Title
Book book, otherBook;

var query = new SqlQuerySpec(
    "SELECT * FROM books b WHERE b.title = @title", 
    new SqlParameterCollection(new SqlParameter[] { new SqlParameter { Name = "@title", Value = "War and Peace" }}));
book = client.CreateDocumentQuery<Book>(collectionLink, query).AsEnumerable().FirstOrDefault();

// Query a nested property
query = new SqlQuerySpec(
    "SELECT * FROM books b WHERE b.Author.FirstName = @firstName", 
    new SqlParameterCollection(new SqlParameter[] { new SqlParameter { Name = "@firstName", Value = "Leo" }}));
otherBook = client.CreateDocumentQuery<Book>(collectionLink, query).AsEnumerable().FirstOrDefault();

// Perform a range query (needs an IndexType.Range on price or FeedOptions.EnableScansInQuery)
query = new SqlQuerySpec(
    "SELECT * FROM books b WHERE b.Price > @minPrice", 
    new SqlParameterCollection(new SqlParameter[] { new SqlParameter { Name = "@minPrice", Value = 1000 }}));
foreach (Book b in client.CreateDocumentQuery<Book>(
    collectionLink, query))
{
    // Iterate through books
}

// Query asychronously. Optionally set FeedOptions.MaxItemCount to control page size
query = new SqlQuerySpec(
    "SELECT * FROM books b WHERE b.title = @title", 
    new SqlParameterCollection(new SqlParameter[] { new SqlParameter { Name = "@title", Value = "War and Peace" }}));

using (var queryable = client.CreateDocumentQuery<Book>(collectionLink, query, 
    new FeedOptions { MaxItemCount = 10 }).AsDocumentQuery())
{
    while (queryable.HasMoreResults) 
    {
        foreach(Book b in await queryable.ExecuteNextAsync<Book>())
        {
            // Iterate through books
        }
    }
}

注釈

構文と例については、 を https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started/ 参照してください。

こちらもご覧ください

適用対象

CreateDocumentQuery<T>(String, FeedOptions, Object)

注意事項

Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.

オーバーロードされます。 このメソッドは、Azure Cosmos DB サービスのコレクションの下にドキュメントのクエリを作成します。

[System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")]
public System.Linq.IOrderedQueryable<T> CreateDocumentQuery<T> (string documentsFeedOrDatabaseLink, Microsoft.Azure.Documents.Client.FeedOptions feedOptions, object partitionKey);
[<System.Obsolete("Support for IPartitionResolver based method overloads is now obsolete. It's recommended that you use partitioned collections for higher storage and throughput. Please use the override that does not take a partitionKey parameter.")>]
member this.CreateDocumentQuery : string * Microsoft.Azure.Documents.Client.FeedOptions * obj -> System.Linq.IOrderedQueryable<'T>
Public Function CreateDocumentQuery(Of T) (documentsFeedOrDatabaseLink As String, feedOptions As FeedOptions, partitionKey As Object) As IOrderedQueryable(Of T)

型パラメーター

T

クエリを実行するオブジェクトの型。

パラメーター

documentsFeedOrDatabaseLink
String

コレクションの下にあるドキュメントのパス リンク (dbs/db_rid/colls/coll_rid/docs/ など)。 または、IPartitionResolver (dbs/db_rid/ など) を使用する場合は、データベースへのパス リンクを指定することもできます。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。 詳細については、FeedOptions を参照してください

partitionKey
Object

IPartitionResolver で使用できるパーティション キー。

戻り値

クエリを評価できる IOrderedQueryable{T}。

属性

注釈

IPartitionResolver ベースのメソッド オーバーロードのサポートは廃止されました。 より高いストレージとスループットを実現するために 、パーティション分割コレクションを 使用することをお勧めします。

適用対象

CreateDocumentQuery<T>(Uri, FeedOptions)

Azure Cosmos DB サービスでドキュメントのクエリを作成する拡張メソッド。

public System.Linq.IOrderedQueryable<T> CreateDocumentQuery<T> (Uri documentCollectionUri, Microsoft.Azure.Documents.Client.FeedOptions feedOptions = default);
abstract member CreateDocumentQuery : Uri * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IOrderedQueryable<'T>
override this.CreateDocumentQuery : Uri * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IOrderedQueryable<'T>
Public Function CreateDocumentQuery(Of T) (documentCollectionUri As Uri, Optional feedOptions As FeedOptions = Nothing) As IOrderedQueryable(Of T)

型パラメーター

T

クエリを実行するオブジェクトの型。

パラメーター

documentCollectionUri
Uri

ドキュメント コレクションの URI。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。

戻り値

クエリ結果セット。

実装

適用対象

CreateDocumentQuery<T>(String, FeedOptions)

オーバーロードされます。 このメソッドは、Azure Cosmos DB サービスのコレクションの下にドキュメントのクエリを作成します。

public System.Linq.IOrderedQueryable<T> CreateDocumentQuery<T> (string collectionLink, Microsoft.Azure.Documents.Client.FeedOptions feedOptions = default);
abstract member CreateDocumentQuery : string * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IOrderedQueryable<'T>
override this.CreateDocumentQuery : string * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IOrderedQueryable<'T>
Public Function CreateDocumentQuery(Of T) (collectionLink As String, Optional feedOptions As FeedOptions = Nothing) As IOrderedQueryable(Of T)

型パラメーター

T

クエリを実行するオブジェクトの型。

パラメーター

collectionLink
String

親コレクション リソースへのリンク。

feedOptions
FeedOptions

クエリ結果フィードを処理するためのオプション。 詳細については、FeedOptions を参照してください

戻り値

クエリを評価できる IOrderedQueryable{T}。

実装

次の例では、一部の書籍ドキュメントのクエリを実行します。

public class Book 
{
    [JsonProperty("title")]
    public string Title {get; set;}

    public Author Author {get; set;}

    public int Price {get; set;}
}

public class Author
{
    public string FirstName {get; set;}
    public string LastName {get; set;}
}

// Query by the Title property
Book book = client.CreateDocumentQuery<Book>(collectionLink).Where(b => b.Title == "War and Peace").AsEnumerable().FirstOrDefault();

// Query a nested property
Book otherBook = client.CreateDocumentQuery<Book>(collectionLink).Where(b => b.Author.FirstName == "Leo").AsEnumerable().FirstOrDefault();

// Perform a range query (needs an IndexType.Range on price or FeedOptions.EnableScansInQuery)
foreach (Book matchingBook in client.CreateDocumentQuery<Book>(collectionLink).Where(b => b.Price > 100))
{
    // Iterate through books
}

// Query asychronously. Optionally set FeedOptions.MaxItemCount to control page size
using (var queryable = client.CreateDocumentQuery<Book>(
    collectionLink,
    new FeedOptions { MaxItemCount = 10 })
    .Where(b => b.Title == "War and Peace")
    .AsDocumentQuery())
{
    while (queryable.HasMoreResults) 
    {
        foreach(Book b in await queryable.ExecuteNextAsync<Book>())
        {
            // Iterate through books
        }
    }
}

注釈

Azure Cosmos DB LINQ プロバイダーは、LINQ to SQL ステートメントをコンパイルします。 https://docs.microsoft.com/azure/cosmos-db/sql-query-linq-to-sql Azure Cosmos DB LINQ プロバイダーでサポートされている式の一覧については、こちらを参照してください。 生成された IQueryable の ToString() は、変換された SQL ステートメントを返します。 Azure Cosmos DB プロバイダーは、メンバーの JSON.NET および DataContract シリアル化属性を JSON プロパティ名に変換します。

こちらもご覧ください

適用対象