CosmosDatabase.GetContainerQueryIterator Método

Definição

Namespace:

Azure.Cosmos

Assembly:

Azure.Cosmos.dll

Pacote:

Azure.Cosmos v4.0.0-preview3

Sobrecargas

GetContainerQueryIterator<T>(String, String, QueryRequestOptions, CancellationToken)	Esse método cria uma consulta para contêineres em um banco de dados usando uma instrução SQL. Ele retorna um FeedIterator. Para obter mais informações sobre como preparar instruções SQL com valores parametrizados, consulte QueryDefinition sobrecarga.
GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions, CancellationToken)	Esse método cria uma consulta para contêineres em um banco de dados usando uma instrução SQL. Ele retorna um FeedIterator. Para obter mais informações sobre como preparar instruções SQL com valores parametrizados, consulte QueryDefinition sobrecarga.

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

Esse método cria uma consulta para contêineres em um banco de dados usando uma instrução SQL. Ele retorna um FeedIterator. Para obter mais informações sobre como preparar instruções SQL com valores parametrizados, consulte QueryDefinition sobrecarga.

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)

Parâmetros de tipo

T

Parâmetros

queryText

String

O texto da consulta DO COSMOS SQL.

continuationToken

String

(Opcional) O token de continuação no serviço do Azure Cosmos DB.

requestOptions

QueryRequestOptions

(Opcional) As opções para a solicitação de consulta de item QueryRequestOptions

cancellationToken

CancellationToken

(Opcional) CancellationToken que representa o cancelamento da solicitação.

Retornos

AsyncPageable<T>

Um iterador para percorrer os contêineres

Exemplos

1. Isso cria o iterador de feed de tipo para contêineres com queryText como entrada,

string queryText = "SELECT * FROM c where c.id like '%testId%'";
await foreach(ContainerProperties properties in this.cosmosDatabase.GetContainerQueryIterator<ContainerProperties>(querytext))
{
    Console.WriteLine(properties.Id);
}

2. Isso cria o iterador de feed de tipo para contêineres sem queryText, recuperando todos os contêineres.

await foreach(ContainerProperties properties in this.cosmosDatabase.GetContainerQueryIterator<ContainerProperties>())
{
    Console.WriteLine(properties.Id);
}

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

Esse método cria uma consulta para contêineres em um banco de dados usando uma instrução SQL. Ele retorna um FeedIterator. Para obter mais informações sobre como preparar instruções SQL com valores parametrizados, consulte QueryDefinition sobrecarga.

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)

Parâmetros de tipo

T

Parâmetros

queryDefinition

QueryDefinition

A definição de consulta DO COSMOS SQL.

continuationToken

String

(Opcional) O token de continuação no serviço do Azure Cosmos DB.

requestOptions

QueryRequestOptions

(Opcional) As opções para a solicitação de consulta de item QueryRequestOptions

cancellationToken

CancellationToken

(Opcional) CancellationToken que representa o cancelamento da solicitação.

Retornos

AsyncPageable<T>

Um iterador para percorrer os contêineres

Exemplos

Isso cria o iterador de feed de tipo para contêineres com queryDefinition como entrada.

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