DocumentClient.CreateDocumentQuery Methode

Referenz

Definition

Namespace:: Microsoft.Azure.Documents.Client

Assemblys:: Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll

Pakete:: Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.0

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

CreateDocumentQuery(String, SqlQuerySpec, FeedOptions, Object)	Veraltet. Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einer Azure Cosmos DB-Datenbank mithilfe einer SQL-Anweisung mit parametrisierten Werten. Es wird ein IQueryable{dynamic} zurückgegeben. Weitere Informationen zum Vorbereiten von SQL-Anweisungen mit parametrisierten Werten finden Sie unter SqlQuerySpec.
CreateDocumentQuery(String, String, FeedOptions, Object)	Veraltet. Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einer Azure Cosmos DB-Datenbank mithilfe einer SQL-Anweisung. Es wird ein IQueryable{dynamic} zurückgegeben.
CreateDocumentQuery(Uri, String, FeedOptions)	Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.
CreateDocumentQuery(Uri, String, FeedOptions, Object)	Veraltet. Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.
CreateDocumentQuery(Uri, SqlQuerySpec, FeedOptions, Object)	Veraltet. Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.
CreateDocumentQuery(Uri, SqlQuerySpec, FeedOptions)	Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.
CreateDocumentQuery(String, String, FeedOptions)	Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einer Azure Cosmos DB-Datenbank mithilfe einer SQL-Anweisung. Es wird ein IQueryable{dynamic} zurückgegeben.
CreateDocumentQuery(String, SqlQuerySpec, FeedOptions)	Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einer Azure Cosmos DB-Datenbank mithilfe einer SQL-Anweisung mit parametrisierten Werten. Es wird ein IQueryable{dynamic} zurückgegeben. Weitere Informationen zum Vorbereiten von SQL-Anweisungen mit parametrisierten Werten finden Sie unter SqlQuerySpec.
CreateDocumentQuery(String, FeedOptions, Object)	Veraltet. Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einem Azure Cosmos DB-Dienst. Es wird IOrderedQueryable{Document} zurückgegeben.
CreateDocumentQuery(Uri, FeedOptions)	Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.
CreateDocumentQuery(String, FeedOptions)	Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einem Azure Cosmos DB-Dienst. Es wird IOrderedQueryable{Document} zurückgegeben.
CreateDocumentQuery(Uri, FeedOptions, Object)	Veraltet. Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.
CreateDocumentQuery<T>(Uri, SqlQuerySpec, FeedOptions)	Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.
CreateDocumentQuery<T>(Uri, String, FeedOptions, Object)	Veraltet. Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.
CreateDocumentQuery<T>(Uri, SqlQuerySpec, FeedOptions, Object)	Veraltet. Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente für den Azure Cosmos DB-Dienst.
CreateDocumentQuery<T>(String, String, FeedOptions, Object)	Veraltet. Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einer Azure Cosmos DB-Datenbank mithilfe einer SQL-Anweisung. Es wird ein IQueryable{T} zurückgegeben.
CreateDocumentQuery<T>(String, SqlQuerySpec, FeedOptions, Object)	Veraltet. Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einer Azure Cosmos DB-Datenbank mithilfe einer SQL-Anweisung mit parametrisierten Werten. Es wird ein IQueryable{T} zurückgegeben. Weitere Informationen zum Vorbereiten von SQL-Anweisungen mit parametrisierten Werten finden Sie unter SqlQuerySpec.
CreateDocumentQuery<T>(Uri, String, FeedOptions)	Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.
CreateDocumentQuery<T>(Uri, FeedOptions, Object)	Veraltet. Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.
CreateDocumentQuery<T>(String, String, FeedOptions)	Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einer Azure Cosmos DB-Datenbank mithilfe einer SQL-Anweisung. Es wird ein IQueryable{T} zurückgegeben.
CreateDocumentQuery<T>(String, SqlQuerySpec, FeedOptions)	Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einer Azure Cosmos DB-Datenbank mithilfe einer SQL-Anweisung mit parametrisierten Werten. Es wird ein IQueryable{T} zurückgegeben. Weitere Informationen zum Vorbereiten von SQL-Anweisungen mit parametrisierten Werten finden Sie unter SqlQuerySpec.
CreateDocumentQuery<T>(String, FeedOptions, Object)	Veraltet. Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einem Azure Cosmos DB-Dienst.
CreateDocumentQuery<T>(Uri, FeedOptions)	Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.
CreateDocumentQuery<T>(String, FeedOptions)	Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einem Azure Cosmos DB-Dienst.

CreateDocumentQuery(String, SqlQuerySpec, FeedOptions, Object)

Achtung

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.

Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einer Azure Cosmos DB-Datenbank mithilfe einer SQL-Anweisung mit parametrisierten Werten. Es wird ein IQueryable{dynamic} zurückgegeben. Weitere Informationen zum Vorbereiten von SQL-Anweisungen mit parametrisierten Werten finden Sie unter 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)

Parameter

collectionLink: String

Der Link zur übergeordneten Dokumentauflistung. Alternativ kann dies bei Verwendung eines IPartitionResolvers ein Pfadlink zur Datenbank sein, z. B. dbs/db_rid/

querySpec: SqlQuerySpec

Die SqlQuerySpec-instance, die den SQL-Ausdruck enthält.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds. Weitere Informationen finden Sie unter FeedOptions.

partitionKey: Object

Der Partitionsschlüssel, der mit einem IPartitionResolver verwendet werden kann.

Gibt zurück

IQueryable<Object>

ein IQueryable{dynamic> , das die Abfrage auswerten kann.

Attribute: ObsoleteAttribute

Hinweise

Die Unterstützung für IPartitionResolver-basierte Methodenüberladungen ist jetzt veraltet. Es wird empfohlen, partitionierte Sammlungen für höheren Speicher und Durchsatz zu verwenden.

Gilt für:

CreateDocumentQuery(String, String, FeedOptions, Object)

Achtung

Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einer Azure Cosmos DB-Datenbank mithilfe einer SQL-Anweisung. Es wird ein IQueryable{dynamic} zurückgegeben.

[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)

Parameter

collectionLink: String

Der Link der übergeordneten Dokumentauflistung. Alternativ kann dies bei Verwendung eines IPartitionResolvers ein Pfadlink zur Datenbank sein, z. B. dbs/db_rid/

sqlExpression: String

Die SQL-Anweisung.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds. Weitere Informationen finden Sie unter FeedOptions.

partitionKey: Object

Der Partitionsschlüssel, der mit einem IPartitionResolver verwendet werden kann.

Gibt zurück

IQueryable<Object>

ein IQueryable{dynamic> , das die Abfrage auswerten kann.

Attribute: ObsoleteAttribute

Hinweise

Die Unterstützung für IPartitionResolver-basierte Methodenüberladungen ist jetzt veraltet. Es wird empfohlen, partitionierte Sammlungen für höheren Speicher und Durchsatz zu verwenden.

Gilt für:

CreateDocumentQuery(Uri, String, FeedOptions)

Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.

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)

Parameter

documentCollectionOrDatabaseUri: Uri

Der URI der Dokumentauflistung.

sqlExpression: String

Die SQL-Abfrage.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds.

Gibt zurück

IQueryable<Object>

Das Abfrageresultset.

Implementiert

CreateDocumentQuery(Uri, String, FeedOptions)

Gilt für:

CreateDocumentQuery(Uri, String, FeedOptions, Object)

Achtung

Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.

[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)

Parameter

documentCollectionOrDatabaseUri: Uri

Der URI der Dokumentauflistung, z. B. dbs/db_rid/colls/coll_rid/. Alternativ kann dies ein URI der Datenbank sein, wenn ein IPartitionResolververwendet wird, z. B. dbs/db_rid/

sqlExpression: String

Die SQL-Abfrage.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds.

partitionKey: Object

Der Partitionsschlüssel, der mit einem IPartitionResolver verwendet werden kann.

Gibt zurück

IQueryable<Object>

Das Abfrageresultset.

Attribute: ObsoleteAttribute

Hinweise

Die Unterstützung für IPartitionResolver-basierte Methodenüberladungen ist jetzt veraltet. Es wird empfohlen, partitionierte Sammlungen für höheren Speicher und Durchsatz zu verwenden.

Gilt für:

CreateDocumentQuery(Uri, SqlQuerySpec, FeedOptions, Object)

Achtung

Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.

[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)

Parameter

documentCollectionOrDatabaseUri: Uri

Der URI der Dokumentauflistung, z. B. dbs/db_rid/colls/coll_rid/. Alternativ kann dies ein URI der Datenbank sein, wenn ein IPartitionResolververwendet wird, z. B. dbs/db_rid/

querySpec: SqlQuerySpec

Die SQL-Abfrage.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds.

partitionKey: Object

Der Partitionsschlüssel, der mit einem IPartitionResolver verwendet werden kann.

Gibt zurück

IQueryable<Object>

Das Abfrageresultset.

Attribute: ObsoleteAttribute

Hinweise

Die Unterstützung für IPartitionResolver-basierte Methodenüberladungen ist jetzt veraltet. Es wird empfohlen, partitionierte Sammlungen für höheren Speicher und Durchsatz zu verwenden.

Gilt für:

CreateDocumentQuery(Uri, SqlQuerySpec, FeedOptions)

Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.

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)

Parameter

documentCollectionOrDatabaseUri: Uri

Der URI der Dokumentauflistung.

querySpec: SqlQuerySpec

Die SQL-Abfrage.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds.

Gibt zurück

IQueryable<Object>

Das Abfrageresultset.

Implementiert

CreateDocumentQuery(Uri, SqlQuerySpec, FeedOptions)

Gilt für:

CreateDocumentQuery(String, String, FeedOptions)

Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einer Azure Cosmos DB-Datenbank mithilfe einer SQL-Anweisung. Es wird ein IQueryable{dynamic} zurückgegeben.

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)

Parameter

collectionLink: String

Der Link zur übergeordneten Dokumentauflistung.

sqlExpression: String

Die SQL-Anweisung.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds. Weitere Informationen finden Sie unter FeedOptions.

Gibt zurück

IQueryable<Object>

ein IQueryable{dynamic> , das die Abfrage auswerten kann.

Implementiert

CreateDocumentQuery(String, String, FeedOptions)

Beispiele

In diesem Beispiel unten werden Buchdokumente abfragt.

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

Hinweise

https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started/ Unter finden Sie Syntax und Beispiele.

Weitere Informationen

Gilt für:

CreateDocumentQuery(String, SqlQuerySpec, FeedOptions)

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)

Parameter

collectionLink: String

Der Link zur übergeordneten Dokumentauflistung.

querySpec: SqlQuerySpec

Die SqlQuerySpec-instance, die den SQL-Ausdruck enthält.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds. Weitere Informationen finden Sie unter FeedOptions.

Gibt zurück

IQueryable<Object>

ein IQueryable{dynamic> , das die Abfrage auswerten kann.

Implementiert

CreateDocumentQuery(String, SqlQuerySpec, FeedOptions)

Beispiele

In diesem Beispiel unten werden Buchdokumente abfragt.

// 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();

Hinweise

https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started/ Unter finden Sie Syntax und Beispiele.

Weitere Informationen

Gilt für:

CreateDocumentQuery(String, FeedOptions, Object)

Achtung

Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einem Azure Cosmos DB-Dienst. Es wird IOrderedQueryable{Document} zurückgegeben.

[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)

Parameter

collectionLink: String

Der Link zur übergeordneten Dokumentauflistung. Alternativ kann dies bei Verwendung eines IPartitionResolvers ein Pfadlink zur Datenbank sein.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds. Weitere Informationen finden Sie unter FeedOptions.

partitionKey: Object

Optionaler Partitionsschlüssel, der mit einem IPartitionResolver verwendet werden kann.

Gibt zurück

IOrderedQueryable<Document>

Ein IOrderedQueryable{Document}-Element, das die Abfrage auswerten kann.

Attribute: ObsoleteAttribute

Hinweise

Die Unterstützung für IPartitionResolver-basierte Methodenüberladungen ist jetzt veraltet. Es wird empfohlen, partitionierte Sammlungen für höheren Speicher und Durchsatz zu verwenden.

Gilt für:

CreateDocumentQuery(Uri, FeedOptions)

Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.

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)

Parameter

documentCollectionOrDatabaseUri: Uri

Der URI der Dokumentauflistung.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds.

Gibt zurück

IOrderedQueryable<Document>

Das Abfrageresultset.

Implementiert

CreateDocumentQuery(Uri, FeedOptions)

Gilt für:

CreateDocumentQuery(String, FeedOptions)

Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einem Azure Cosmos DB-Dienst. Es wird IOrderedQueryable{Document} zurückgegeben.

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)

Parameter

collectionLink: String

Der Link zur übergeordneten Dokumentauflistung.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds. Weitere Informationen finden Sie unter FeedOptions.

Gibt zurück

IOrderedQueryable<Document>

Ein IOrderedQueryable{Document}-Element, das die Abfrage auswerten kann.

Implementiert

CreateDocumentQuery(String, FeedOptions)

Beispiele

In diesem Beispiel unten werden Dokumente anhand der ID abfragt.

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

Hinweise

Diese Überladung sollte verwendet werden, wenn das Schema der abgefragten Dokumente unbekannt ist oder wenn Sie nach ID abfragen und Dokumente ersetzen/löschen. Da Es sich bei Document um ein dynamisches Objekt handelt, kann es dynamisch in das ursprüngliche C#-Objekt zurück umgewandelt werden.

Weitere Informationen

Gilt für:

CreateDocumentQuery(Uri, FeedOptions, Object)

Achtung

Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.

[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)

Parameter

documentCollectionOrDatabaseUri: Uri

Der URI der Dokumentauflistung, z. B. dbs/db_rid/colls/coll_rid/. Alternativ kann dies ein URI der Datenbank sein, wenn ein IPartitionResolververwendet wird, z. B. dbs/db_rid/

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds.

partitionKey: Object

Der Partitionsschlüssel, der mit einem IPartitionResolver verwendet werden kann.

Gibt zurück

IOrderedQueryable<Document>

Das Abfrageresultset.

Attribute: ObsoleteAttribute

Hinweise

Die Unterstützung für IPartitionResolver-basierte Methodenüberladungen ist jetzt veraltet. Es wird empfohlen, partitionierte Sammlungen für höheren Speicher und Durchsatz zu verwenden.

Gilt für:

CreateDocumentQuery<T>(Uri, SqlQuerySpec, FeedOptions)

Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.

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)

Typparameter

T

Der Typ des abzufragenden Objekts.

Parameter

documentCollectionOrDatabaseUri: Uri

Der URI der Dokumentauflistung.

querySpec: SqlQuerySpec

Die SQL-Abfrage.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds.

Gibt zurück

IQueryable<T>

Das Abfrageresultset.

Implementiert

CreateDocumentQuery<T>(Uri, SqlQuerySpec, FeedOptions)

Gilt für:

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

Achtung

Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.

[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)

Typparameter

T

Der Typ des abzufragenden Objekts.

Parameter

documentCollectionOrDatabaseUri: Uri

Der URI der Dokumentauflistung, z. B. dbs/db_rid/colls/coll_rid/. Alternativ kann dies ein URI der Datenbank sein, wenn ein IPartitionResolververwendet wird, z. B. dbs/db_rid/

sqlExpression: String

Die SQL-Abfrage.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds.

partitionKey: Object

Der Partitionsschlüssel, der mit einem IPartitionResolver verwendet werden kann.

Gibt zurück

IQueryable<T>

Das Abfrageresultset.

Attribute: ObsoleteAttribute

Hinweise

Die Unterstützung für IPartitionResolver-basierte Methodenüberladungen ist jetzt veraltet. Es wird empfohlen, partitionierte Sammlungen für höheren Speicher und Durchsatz zu verwenden.

Gilt für:

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

Achtung

Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente für den Azure Cosmos DB-Dienst.

[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)

Typparameter

T

Der Typ des abzufragenden Objekts.

Parameter

documentCollectionOrDatabaseUri: Uri

Der URI der Dokumentauflistung, z. B. dbs/db_rid/colls/coll_rid/. Alternativ kann dies ein URI der Datenbank sein, wenn ein IPartitionResolververwendet wird, z. B. dbs/db_rid/

querySpec: SqlQuerySpec

Die SQL-Abfrage.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds.

partitionKey: Object

Der Partitionsschlüssel, der mit einem IPartitionResolver verwendet werden kann.

Gibt zurück

IQueryable<T>

Das Abfrageresultset.

Attribute: ObsoleteAttribute

Hinweise

Die Unterstützung für IPartitionResolver-basierte Methodenüberladungen ist jetzt veraltet. Es wird empfohlen, partitionierte Sammlungen für höheren Speicher und Durchsatz zu verwenden.

Gilt für:

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

Achtung

Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einer Azure Cosmos DB-Datenbank mithilfe einer SQL-Anweisung. Es wird ein IQueryable{T} zurückgegeben.

[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)

Typparameter

T

Der Typ des abzufragenden Objekts.

Parameter

collectionLink: String

Der Pfadlink für die Dokumente unter einer Sammlung, z. B. dbs/db_rid/colls/coll_rid/docs/. Alternativ kann dies bei Verwendung eines IPartitionResolvers ein Pfadlink zur Datenbank sein, z. B. dbs/db_rid/

sqlExpression: String

Die SQL-Anweisung.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds. Weitere Informationen finden Sie unter FeedOptions.

partitionKey: Object

Der Partitionsschlüssel, der mit einem IPartitionResolver verwendet werden kann.

Gibt zurück

IQueryable<T>

Ein IQueryable{T}, das die Abfrage auswerten kann.

Attribute: ObsoleteAttribute

Hinweise

Die Unterstützung für IPartitionResolver-basierte Methodenüberladungen ist jetzt veraltet. Es wird empfohlen, partitionierte Sammlungen für höheren Speicher und Durchsatz zu verwenden.

Gilt für:

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

Achtung

Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einer Azure Cosmos DB-Datenbank mithilfe einer SQL-Anweisung mit parametrisierten Werten. Es wird ein IQueryable{T} zurückgegeben. Weitere Informationen zum Vorbereiten von SQL-Anweisungen mit parametrisierten Werten finden Sie unter 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)

Typparameter

T

Der Typ des abzufragenden Objekts.

Parameter

collectionLink: String

Der Link zur übergeordneten Dokumentauflistung. Alternativ kann dies bei Verwendung eines IPartitionResolvers ein Pfadlink zur Datenbank sein.

querySpec: SqlQuerySpec

Die SqlQuerySpec-instance, die den SQL-Ausdruck enthält.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds. Weitere Informationen finden Sie unter FeedOptions.

partitionKey: Object

Der Partitionsschlüssel, der mit einem IPartitionResolver verwendet werden kann.

Gibt zurück

IQueryable<T>

Ein IQueryable{T}, das die Abfrage auswerten kann.

Attribute: ObsoleteAttribute

Hinweise

Die Unterstützung für IPartitionResolver-basierte Methodenüberladungen ist jetzt veraltet. Es wird empfohlen, partitionierte Sammlungen für höheren Speicher und Durchsatz zu verwenden.

Gilt für:

CreateDocumentQuery<T>(Uri, String, FeedOptions)

Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.

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)

Typparameter

T

der Typ des abzufragenden Objekts.

Parameter

documentCollectionOrDatabaseUri: Uri

Der URI der Dokumentauflistung.

sqlExpression: String

Die SQL-Abfrage.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds.

Gibt zurück

IQueryable<T>

Das Abfrageresultset.

Implementiert

CreateDocumentQuery<T>(Uri, String, FeedOptions)

Gilt für:

CreateDocumentQuery<T>(Uri, FeedOptions, Object)

Achtung

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

Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.

[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)

Typparameter

T

der Typ des abzufragenden Objekts.

Parameter

documentCollectionOrDatabaseUri: Uri

Der URI der Dokumentauflistung, z. B. dbs/db_rid/colls/coll_rid/. Alternativ kann dies ein URI der Datenbank sein, wenn ein IPartitionResolververwendet wird, z. B. dbs/db_rid/

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds.

partitionKey: Object

Der Partitionsschlüssel, der mit einem IPartitionResolver verwendet werden kann.

Gibt zurück

IOrderedQueryable<T>

Das Abfrageresultset.

Attribute: ObsoleteAttribute

Hinweise

Die Unterstützung für IPartitionResolver-basierte Methodenüberladungen ist jetzt veraltet. Es wird empfohlen, partitionierte Sammlungen für höheren Speicher und Durchsatz zu verwenden.

Gilt für:

CreateDocumentQuery<T>(String, String, FeedOptions)

Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einer Azure Cosmos DB-Datenbank mithilfe einer SQL-Anweisung. Es wird ein IQueryable{T} zurückgegeben.

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)

Typparameter

T

Der Typ des abzufragenden Objekts.

Parameter

collectionLink: String

Der Link zur übergeordneten Auflistung.

sqlExpression: String

Die SQL-Anweisung.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds. Weitere Informationen finden Sie unter FeedOptions.

Gibt zurück

IQueryable<T>

Ein IQueryable{T}, das die Abfrage auswerten kann.

Implementiert

CreateDocumentQuery<T>(String, String, FeedOptions)

Beispiele

Dieses Beispiel unten fragt einige Buchdokumente ab.

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
        }
    }
}

Hinweise

https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started/ Unter finden Sie Syntax und Beispiele.

Weitere Informationen

Gilt für:

CreateDocumentQuery<T>(String, SqlQuerySpec, FeedOptions)

Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einer Azure Cosmos DB-Datenbank mithilfe einer SQL-Anweisung mit parametrisierten Werten. Es wird ein IQueryable{T} zurückgegeben. Weitere Informationen zum Vorbereiten von SQL-Anweisungen mit parametrisierten Werten finden Sie unter 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)

Typparameter

T

Der Typ des abzufragenden Objekts.

Parameter

collectionLink: String

Der Link zur übergeordneten Dokumentauflistung.

querySpec: SqlQuerySpec

Die SqlQuerySpec-instance, die den SQL-Ausdruck enthält.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds. Weitere Informationen finden Sie unter FeedOptions.

Gibt zurück

IQueryable<T>

Ein IQueryable{T}, das die Abfrage auswerten kann.

Implementiert

CreateDocumentQuery<T>(String, SqlQuerySpec, FeedOptions)

Beispiele

Dieses Beispiel unten fragt einige Buchdokumente ab.

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
        }
    }
}

Hinweise

https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started/ Unter finden Sie Syntax und Beispiele.

Weitere Informationen

Gilt für:

CreateDocumentQuery<T>(String, FeedOptions, Object)

Achtung

Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einem Azure Cosmos DB-Dienst.

[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)

Typparameter

T

Der Typ des abzufragenden Objekts.

Parameter

documentsFeedOrDatabaseLink: String

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds. Weitere Informationen finden Sie unter FeedOptions.

partitionKey: Object

Der Partitionsschlüssel, der mit einem IPartitionResolver verwendet werden kann.

Gibt zurück

IOrderedQueryable<T>

Ein IOrderedQueryable{T}, das die Abfrage auswerten kann.

Attribute: ObsoleteAttribute

Hinweise

Die Unterstützung für IPartitionResolver-basierte Methodenüberladungen ist jetzt veraltet. Es wird empfohlen, partitionierte Sammlungen für höheren Speicher und Durchsatz zu verwenden.

Gilt für:

CreateDocumentQuery<T>(Uri, FeedOptions)

Erweiterungsmethode zum Erstellen einer Abfrage für Dokumente im Azure Cosmos DB-Dienst.

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)

Typparameter

T

der Typ des abzufragenden Objekts.

Parameter

documentCollectionUri: Uri

Der URI der Dokumentsammlung.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds.

Gibt zurück

IOrderedQueryable<T>

Das Abfrageergebnisset.

Implementiert

CreateDocumentQuery<T>(Uri, FeedOptions)

Gilt für:

CreateDocumentQuery<T>(String, FeedOptions)

Überladen. Diese Methode erstellt eine Abfrage für Dokumente unter einer Sammlung in einem Azure Cosmos DB-Dienst.

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)

Typparameter

T

Der Typ des abzufragenden Objekts.

Parameter

collectionLink: String

Der Link zur übergeordneten Sammlungsressource.

feedOptions: FeedOptions

Die Optionen für die Verarbeitung des Abfrageergebnisfeeds. Weitere Informationen finden Sie unter FeedOptions.

Gibt zurück

IOrderedQueryable<T>

Ein IOrderedQueryable{T}, das die Abfrage auswerten kann.

Implementiert

CreateDocumentQuery<T>(String, FeedOptions)

Beispiele

In diesem Beispiel werden einige Buchdokumente abfragt.

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
        }
    }
}

Hinweise

Der Azure Cosmos DB LINQ-Anbieter kompiliert LINQ to SQL-Anweisungen. https://docs.microsoft.com/azure/cosmos-db/sql-query-linq-to-sql Unter finden Sie die Liste der Ausdrücke, die vom LINQ-Anbieter Azure Cosmos DB unterstützt werden. ToString() auf dem generierten IQueryable gibt die übersetzte SQL-Anweisung zurück. Der Azure Cosmos DB-Anbieter übersetzt JSON.NET- und DataContract-Serialisierungsattribute für Member in deren JSON-Eigenschaftsnamen.

Weitere Informationen

Gilt für:

Freigeben über

DocumentClient.CreateDocumentQuery Methode

Definition

Überlädt

CreateDocumentQuery(String, SqlQuerySpec, FeedOptions, Object)

Parameter

Gibt zurück

Hinweise

Gilt für:

CreateDocumentQuery(String, String, FeedOptions, Object)

Parameter

Gibt zurück

Hinweise

Gilt für:

CreateDocumentQuery(Uri, String, FeedOptions)

Parameter

Gibt zurück

Implementiert

Gilt für:

CreateDocumentQuery(Uri, String, FeedOptions, Object)

Parameter

Gibt zurück

Hinweise

Gilt für:

CreateDocumentQuery(Uri, SqlQuerySpec, FeedOptions, Object)

Parameter

Gibt zurück

Hinweise

Gilt für:

CreateDocumentQuery(Uri, SqlQuerySpec, FeedOptions)

Parameter

Gibt zurück

Implementiert

Gilt für:

CreateDocumentQuery(String, String, FeedOptions)

Parameter

Gibt zurück

Implementiert

Beispiele

Hinweise

Weitere Informationen

Gilt für:

CreateDocumentQuery(String, SqlQuerySpec, FeedOptions)

Parameter

Gibt zurück

Implementiert

Beispiele

Hinweise

Weitere Informationen

Gilt für:

CreateDocumentQuery(String, FeedOptions, Object)

Parameter

Gibt zurück

Hinweise

Gilt für:

CreateDocumentQuery(Uri, FeedOptions)

Parameter

Gibt zurück

Implementiert

Gilt für:

CreateDocumentQuery(String, FeedOptions)

Parameter

Gibt zurück

Implementiert

Beispiele

Hinweise

Weitere Informationen

Gilt für:

CreateDocumentQuery(Uri, FeedOptions, Object)

Parameter

Gibt zurück

Hinweise

Gilt für:

CreateDocumentQuery<T>(Uri, SqlQuerySpec, FeedOptions)

Typparameter

Parameter

Gibt zurück

Implementiert

Gilt für:

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