IDocumentClient.CreateDocumentQuery Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| CreateDocumentQuery(String, FeedOptions) |
Surchargé. Cette méthode crée une requête pour les documents sous une collection dans un service Azure Cosmos DB. Elle renvoie IOrderedQueryable{Document}. |
| CreateDocumentQuery(Uri, FeedOptions) |
Méthode permettant de créer une requête pour des documents dans le service Azure Cosmos DB. |
| CreateDocumentQuery(String, SqlQuerySpec, FeedOptions) |
Surchargé. Cette méthode crée une requête pour les documents sous une collection dans une base de données Azure Cosmos DB à l’aide d’une instruction SQL avec des valeurs paramétrables. Elle retourne un IQueryable{dynamic}. Pour plus d’informations sur la préparation des instructions SQL avec des valeurs paramétrables, consultez SqlQuerySpec. |
| CreateDocumentQuery(String, String, FeedOptions) |
Surchargé. Cette méthode crée une requête pour les documents sous une collection dans une base de données Azure Cosmos DB à l’aide d’une instruction SQL. Elle retourne un IQueryable{dynamic}. |
| CreateDocumentQuery(Uri, SqlQuerySpec, FeedOptions) |
Méthode permettant de créer une requête pour des documents dans le service Azure Cosmos DB. |
| CreateDocumentQuery(Uri, String, FeedOptions) |
Méthode permettant de créer une requête pour des documents dans le service Azure Cosmos DB. |
| CreateDocumentQuery<T>(Uri, SqlQuerySpec, FeedOptions) |
Méthode permettant de créer une requête pour des documents dans le service Azure Cosmos DB. |
| CreateDocumentQuery<T>(Uri, String, FeedOptions) |
Méthode permettant de créer une requête pour des documents dans le service Azure Cosmos DB. |
| CreateDocumentQuery<T>(String, String, FeedOptions) |
Surchargé. Cette méthode crée une requête pour les documents sous une collection dans une base de données Azure Cosmos DB à l’aide d’une instruction SQL. Elle retourne un IQueryable{T}. |
| CreateDocumentQuery<T>(String, SqlQuerySpec, FeedOptions) |
Surchargé. Cette méthode crée une requête pour les documents sous une collection dans une base de données Azure Cosmos DB à l’aide d’une instruction SQL avec des valeurs paramétrables. Elle retourne un IQueryable{T}. Pour plus d’informations sur la préparation des instructions SQL avec des valeurs paramétrables, consultez SqlQuerySpec. |
| CreateDocumentQuery<T>(Uri, FeedOptions) |
Méthode permettant de créer une requête pour des documents dans le service Azure Cosmos DB. |
| CreateDocumentQuery<T>(String, FeedOptions) |
Surchargé. Cette méthode crée une requête pour les documents sous une collection dans un service Azure Cosmos DB. |
CreateDocumentQuery(String, FeedOptions)
Surchargé. Cette méthode crée une requête pour les documents sous une collection dans un service Azure Cosmos DB. Elle renvoie 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>Public Function CreateDocumentQuery (collectionLink As String, Optional feedOptions As FeedOptions = Nothing) As IOrderedQueryable(Of Document)Paramètres
- collectionLink
- String
Lien vers la collection de documents parent.
- feedOptions
- FeedOptions
Options de traitement du flux de résultats de requête. Pour plus d’informations, consultez FeedOptions
Retours
IOrderedQueryable{Document} qui peut évaluer la requête.
Exemples
Cet exemple ci-dessous interroge les documents par ID.
Document document = client.CreateDocumentQuery<Document>(collectionLink)
.Where(d => d.Id == "War and Peace").AsEnumerable().FirstOrDefault();
Remarques
Cette surcharge doit être utilisée lorsque le schéma des documents interrogés est inconnu ou lors de l’interrogation par ID et du remplacement/suppression de documents. Étant donné que Document est un DynamicObject, il peut être converti dynamiquement en objet C# d’origine.
Voir aussi
S’applique à
CreateDocumentQuery(Uri, FeedOptions)
Méthode permettant de créer une requête pour des documents dans le service Azure Cosmos DB.
public System.Linq.IOrderedQueryable<Microsoft.Azure.Documents.Document> CreateDocumentQuery (Uri documentCollectionUri, Microsoft.Azure.Documents.Client.FeedOptions feedOptions = default);abstract member CreateDocumentQuery : Uri * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IOrderedQueryable<Microsoft.Azure.Documents.Document>Public Function CreateDocumentQuery (documentCollectionUri As Uri, Optional feedOptions As FeedOptions = Nothing) As IOrderedQueryable(Of Document)Paramètres
- documentCollectionUri
- Uri
URI de la collection de documents.
- feedOptions
- FeedOptions
(Facultatif) FeedOptions pour le traitement du flux de résultats de requête.
Retours
Jeu de résultats de la requête.
S’applique à
CreateDocumentQuery(String, SqlQuerySpec, FeedOptions)
Surchargé. Cette méthode crée une requête pour les documents sous une collection dans une base de données Azure Cosmos DB à l’aide d’une instruction SQL avec des valeurs paramétrables. Elle retourne un IQueryable{dynamic}. Pour plus d’informations sur la préparation des instructions SQL avec des valeurs paramétrables, consultez 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>Public Function CreateDocumentQuery (collectionLink As String, querySpec As SqlQuerySpec, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of Object)Paramètres
- collectionLink
- String
Lien vers la collection de documents parent.
- querySpec
- SqlQuerySpec
SqlQuerySpec instance contenant l’expression SQL.
- feedOptions
- FeedOptions
Options de traitement du flux de résultats de requête. Pour plus d’informations, consultez FeedOptions
Retours
un IQueryable{dynamic> qui peut évaluer la requête.
Exemples
Cet exemple ci-dessous interroge les documents de livre.
// 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();
Remarques
Reportez-vous à pour obtenir des https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started/ exemples et la syntaxe.
Voir aussi
S’applique à
CreateDocumentQuery(String, String, FeedOptions)
Surchargé. Cette méthode crée une requête pour les documents sous une collection dans une base de données Azure Cosmos DB à l’aide d’une instruction SQL. Elle retourne un 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>Public Function CreateDocumentQuery (collectionLink As String, sqlExpression As String, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of Object)Paramètres
- collectionLink
- String
Lien vers la collection de documents parent.
- sqlExpression
- String
Instruction SQL.
- feedOptions
- FeedOptions
Options de traitement du flux de résultats de requête. Pour plus d’informations, consultez FeedOptions
Retours
un IQueryable{dynamic> qui peut évaluer la requête.
Exemples
Cet exemple ci-dessous interroge les documents de livre.
// SQL querying allows dynamic property access
dynamic document = client.CreateDocumentQuery<dynamic>(collectionLink,
"SELECT * FROM books b WHERE b.title == 'War and Peace'").AsEnumerable().FirstOrDefault();
Remarques
Reportez-vous à pour obtenir des https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started/ exemples et la syntaxe.
Voir aussi
S’applique à
CreateDocumentQuery(Uri, SqlQuerySpec, FeedOptions)
Méthode permettant de créer une requête pour des documents dans le service Azure Cosmos DB.
public System.Linq.IQueryable<dynamic> CreateDocumentQuery (Uri documentCollectionUri, 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>Public Function CreateDocumentQuery (documentCollectionUri As Uri, querySpec As SqlQuerySpec, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of Object)Paramètres
- documentCollectionUri
- Uri
URI de la collection de documents.
- querySpec
- SqlQuerySpec
Requête sql.
- feedOptions
- FeedOptions
(Facultatif) FeedOptions pour le traitement du flux de résultats de requête.
Retours
Jeu de résultats de la requête.
S’applique à
CreateDocumentQuery(Uri, String, FeedOptions)
Méthode permettant de créer une requête pour des documents dans le service Azure Cosmos DB.
public System.Linq.IQueryable<dynamic> CreateDocumentQuery (Uri documentCollectionUri, string sqlExpression, Microsoft.Azure.Documents.Client.FeedOptions feedOptions = default);abstract member CreateDocumentQuery : Uri * string * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<obj>Public Function CreateDocumentQuery (documentCollectionUri As Uri, sqlExpression As String, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of Object)Paramètres
- documentCollectionUri
- Uri
URI de la collection de documents.
- sqlExpression
- String
Requête sql.
- feedOptions
- FeedOptions
(Facultatif) FeedOptions pour le traitement du flux de résultats de requête.
Retours
Jeu de résultats de la requête.
S’applique à
CreateDocumentQuery<T>(Uri, SqlQuerySpec, FeedOptions)
Méthode permettant de créer une requête pour des documents dans le service Azure Cosmos DB.
public System.Linq.IQueryable<T> CreateDocumentQuery<T> (Uri documentCollectionUri, 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>Public Function CreateDocumentQuery(Of T) (documentCollectionUri As Uri, querySpec As SqlQuerySpec, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of T)Paramètres de type
- T
Type d’objet à interroger.
Paramètres
- documentCollectionUri
- Uri
URI de la collection de documents.
- querySpec
- SqlQuerySpec
Requête sql.
- feedOptions
- FeedOptions
(Facultatif) FeedOptions pour le traitement du flux de résultats de requête.
Retours
Jeu de résultats de la requête.
S’applique à
CreateDocumentQuery<T>(Uri, String, FeedOptions)
Méthode permettant de créer une requête pour des documents dans le service Azure Cosmos DB.
public System.Linq.IQueryable<T> CreateDocumentQuery<T> (Uri documentCollectionUri, string sqlExpression, Microsoft.Azure.Documents.Client.FeedOptions feedOptions = default);abstract member CreateDocumentQuery : Uri * string * Microsoft.Azure.Documents.Client.FeedOptions -> System.Linq.IQueryable<'T>Public Function CreateDocumentQuery(Of T) (documentCollectionUri As Uri, sqlExpression As String, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of T)Paramètres de type
- T
Type d’objet à interroger.
Paramètres
- documentCollectionUri
- Uri
URI de la collection de documents.
- sqlExpression
- String
Requête sql.
- feedOptions
- FeedOptions
(Facultatif) FeedOptions pour le traitement du flux des résultats de la requête.
Retours
Jeu de résultats de requête.
S’applique à
CreateDocumentQuery<T>(String, String, FeedOptions)
Surchargé. Cette méthode crée une requête pour les documents sous une collection dans une base de données Azure Cosmos DB à l’aide d’une instruction SQL. Il retourne un 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>Public Function CreateDocumentQuery(Of T) (collectionLink As String, sqlExpression As String, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of T)Paramètres de type
- T
Type d’objet à interroger.
Paramètres
- collectionLink
- String
Lien vers la collection parente.
- sqlExpression
- String
Instruction SQL.
- feedOptions
- FeedOptions
Options permettant de traiter le flux de résultats de requête. Pour plus d’informations, consultez FeedOptions
Retours
IQueryable{T} qui peut évaluer la requête.
Exemples
Cet exemple ci-dessous interroge certains documents de livre.
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
}
}
}
Remarques
Reportez-vous à pour obtenir la https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started/ syntaxe et des exemples.
Voir aussi
S’applique à
CreateDocumentQuery<T>(String, SqlQuerySpec, FeedOptions)
Surchargé. Cette méthode crée une requête pour les documents sous une collection dans une base de données Azure Cosmos DB à l’aide d’une instruction SQL avec des valeurs paramétrables. Il retourne un IQueryable{T}. Pour plus d’informations sur la préparation d’instructions SQL avec des valeurs paramétrables, consultez 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>Public Function CreateDocumentQuery(Of T) (collectionLink As String, querySpec As SqlQuerySpec, Optional feedOptions As FeedOptions = Nothing) As IQueryable(Of T)Paramètres de type
- T
Type d’objet à interroger.
Paramètres
- collectionLink
- String
Lien vers la collection de documents parente.
- querySpec
- SqlQuerySpec
Le instance SqlQuerySpec contenant l’expression SQL.
- feedOptions
- FeedOptions
Options permettant de traiter le flux de résultats de requête. Pour plus d’informations, consultez FeedOptions
Retours
IQueryable{T} qui peut évaluer la requête.
Exemples
Cet exemple ci-dessous interroge certains documents de livre.
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
}
}
}
Remarques
Reportez-vous à pour obtenir la https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started/ syntaxe et des exemples.
Voir aussi
S’applique à
CreateDocumentQuery<T>(Uri, FeedOptions)
Méthode permettant de créer une requête pour des documents dans le service 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>Public Function CreateDocumentQuery(Of T) (documentCollectionUri As Uri, Optional feedOptions As FeedOptions = Nothing) As IOrderedQueryable(Of T)Paramètres de type
- T
Type d’objet à interroger.
Paramètres
- documentCollectionUri
- Uri
URI de la collection de documents parente.
- feedOptions
- FeedOptions
(Facultatif) FeedOptions pour le traitement du flux des résultats de la requête.
Retours
Jeu de résultats de requête.
S’applique à
CreateDocumentQuery<T>(String, FeedOptions)
Surchargé. Cette méthode crée une requête pour les documents sous une collection dans un service 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>Public Function CreateDocumentQuery(Of T) (collectionLink As String, Optional feedOptions As FeedOptions = Nothing) As IOrderedQueryable(Of T)Paramètres de type
- T
Type d’objet à interroger.
Paramètres
- collectionLink
- String
Lien vers la ressource de collection parente.
- feedOptions
- FeedOptions
Options permettant de traiter le flux de résultats de requête. Pour plus d’informations, consultez FeedOptions
Retours
IOrderedQueryable{T} qui peut évaluer la requête.
Exemples
Cet exemple ci-dessous interroge certains documents de livre.
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
}
}
}
Remarques
Le fournisseur LINQ Azure Cosmos DB compile LINQ to SQL instructions. Reportez-vous à https://docs.microsoft.com/azure/cosmos-db/sql-query-linq-to-sql pour obtenir la liste des expressions prises en charge par le fournisseur LINQ Azure Cosmos DB. ToString() sur l’IQueryable généré retourne l’instruction SQL traduite. Le fournisseur Azure Cosmos DB traduit les attributs de sérialisation JSON.NET et DataContract pour les membres en noms de propriétés JSON.
Voir aussi
S’applique à
Azure SDK for .NET