Partager via


CosmosDatabase.GetContainerQueryIterator Méthode

Définition

Surcharges

GetContainerQueryIterator<T>(String, String, QueryRequestOptions, CancellationToken)

Cette méthode crée une requête pour les conteneurs sous une base de données à l’aide d’une instruction SQL. Elle retourne un FeedIterator. Pour plus d’informations sur la préparation des instructions SQL avec des valeurs paramétrables, consultez QueryDefinition surcharge.

GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions, CancellationToken)

Cette méthode crée une requête pour les conteneurs sous une base de données à l’aide d’une instruction SQL. Elle retourne un FeedIterator. Pour plus d’informations sur la préparation des instructions SQL avec des valeurs paramétrables, consultez QueryDefinition surcharge.

GetContainerQueryIterator<T>(String, String, QueryRequestOptions, CancellationToken)

Cette méthode crée une requête pour les conteneurs sous une base de données à l’aide d’une instruction SQL. Elle retourne un FeedIterator. Pour plus d’informations sur la préparation des instructions SQL avec des valeurs paramétrables, consultez QueryDefinition surcharge.

public abstract Azure.AsyncPageable<T> GetContainerQueryIterator<T> (string queryText = default, string continuationToken = default, Azure.Cosmos.QueryRequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member GetContainerQueryIterator : string * string * Azure.Cosmos.QueryRequestOptions * System.Threading.CancellationToken -> Azure.AsyncPageable<'T>
Public MustOverride Function GetContainerQueryIterator(Of T) (Optional queryText As String = Nothing, Optional continuationToken As String = Nothing, Optional requestOptions As QueryRequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As AsyncPageable(Of T)

Paramètres de type

T

Paramètres

queryText
String

Texte de la requête Cosmos SQL.

continuationToken
String

(Facultatif) Jeton de continuation dans le service Azure Cosmos DB.

requestOptions
QueryRequestOptions

(Facultatif) Options de la demande de requête d’élément QueryRequestOptions

cancellationToken
CancellationToken

(Facultatif) CancellationToken représentant l’annulation de la demande.

Retours

Itérateur pour parcourir les conteneurs

Exemples

  1. Cela crée l’itérateur de flux de type pour les conteneurs avec queryText comme entrée,
string queryText = "SELECT * FROM c where c.id like '%testId%'";
await foreach(ContainerProperties properties in this.cosmosDatabase.GetContainerQueryIterator<ContainerProperties>(querytext))
{
    Console.WriteLine(properties.Id);
}
  1. Cela crée l’itérateur de flux de type pour les conteneurs sans queryText, récupérant tous les conteneurs.
await foreach(ContainerProperties properties in this.cosmosDatabase.GetContainerQueryIterator<ContainerProperties>())
{
    Console.WriteLine(properties.Id);
}

S’applique à

GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions, CancellationToken)

Cette méthode crée une requête pour les conteneurs sous une base de données à l’aide d’une instruction SQL. Elle retourne un FeedIterator. Pour plus d’informations sur la préparation des instructions SQL avec des valeurs paramétrables, consultez QueryDefinition surcharge.

public abstract Azure.AsyncPageable<T> GetContainerQueryIterator<T> (Azure.Cosmos.QueryDefinition queryDefinition, string continuationToken = default, Azure.Cosmos.QueryRequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member GetContainerQueryIterator : Azure.Cosmos.QueryDefinition * string * Azure.Cosmos.QueryRequestOptions * System.Threading.CancellationToken -> Azure.AsyncPageable<'T>
Public MustOverride Function GetContainerQueryIterator(Of T) (queryDefinition As QueryDefinition, Optional continuationToken As String = Nothing, Optional requestOptions As QueryRequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As AsyncPageable(Of T)

Paramètres de type

T

Paramètres

queryDefinition
QueryDefinition

Définition de requête Cosmos SQL.

continuationToken
String

(Facultatif) Jeton de continuation dans le service Azure Cosmos DB.

requestOptions
QueryRequestOptions

(Facultatif) Options de la demande de requête d’élément QueryRequestOptions

cancellationToken
CancellationToken

(Facultatif) CancellationToken représentant l’annulation de la demande.

Retours

Itérateur pour parcourir les conteneurs

Exemples

Cela crée l’itérateur de flux de type pour les conteneurs avec queryDefinition comme entrée.

string queryText = "SELECT * FROM c where c.id like @testId";
QueryDefinition queryDefinition = new QueryDefinition(queryText);
queryDefinition.WithParameter("@testId", "testDatabaseId");
await foreach(ContainerProperties properties in this.cosmosDatabase.GetContainerQueryIterator<ContainerProperties>(queryDefinition))
{
    Console.WriteLine(properties.Id);
}

S’applique à