你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Database.GetContainerQueryIterator 方法

定义

命名空间:

Microsoft.Azure.Cosmos

程序集:

Microsoft.Azure.Cosmos.Client.dll

包:

Microsoft.Azure.Cosmos v3.39.0

重载

GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)	此方法使用具有参数化值的 SQL 语句为数据库下的容器创建查询。 它返回 FeedIterator。 有关使用参数化值准备 SQL 语句的详细信息，请参阅 QueryDefinition 重载。
GetContainerQueryIterator<T>(String, String, QueryRequestOptions)	此方法使用 SQL 语句为数据库下的容器创建查询。 它返回 FeedIterator。

GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)

Source:

Database.cs

此方法使用具有参数化值的 SQL 语句为数据库下的容器创建查询。 它返回 FeedIterator。 有关使用参数化值准备 SQL 语句的详细信息，请参阅 QueryDefinition 重载。

public abstract Microsoft.Azure.Cosmos.FeedIterator<T> GetContainerQueryIterator<T> (Microsoft.Azure.Cosmos.QueryDefinition queryDefinition, string continuationToken = default, Microsoft.Azure.Cosmos.QueryRequestOptions requestOptions = default);

abstract member GetContainerQueryIterator : Microsoft.Azure.Cosmos.QueryDefinition * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator<'T>

Public MustOverride Function GetContainerQueryIterator(Of T) (queryDefinition As QueryDefinition, Optional continuationToken As String = Nothing, Optional requestOptions As QueryRequestOptions = Nothing) As FeedIterator(Of T)

类型参数

T

参数

queryDefinition

QueryDefinition

Cosmos SQL 查询定义。

continuationToken

String

(可选) Azure Cosmos DB 服务中的延续令牌。

requestOptions

QueryRequestOptions

(可选) 项查询请求的选项。

返回

FeedIterator<T>

用于遍历容器的迭代器

示例

这将创建类型源迭代器，用于将 queryDefinition 作为输入的容器。

QueryDefinition queryDefinition = new QueryDefinition("SELECT * FROM c where c.status like @status");
    .WithParameter("@status", "start%");
using (FeedIterator<ContainerProperties> feedIterator = this.cosmosDatabase.GetContainerQueryIterator<ContainerProperties>(queryDefinition))
{
    while (feedIterator.HasMoreResults)
    {
        FeedResponse<ContainerProperties> response = await feedIterator.ReadNextAsync();
        foreach (var container in response)
        {
            Console.WriteLine(container);
        }
    }
}

注解

有关语法和示例， https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started 请参阅 。

ReadContainerAsync(ContainerRequestOptions, CancellationToken) 建议用于单容器查找。

GetContainerQueryIterator<T>(String, String, QueryRequestOptions)

Source:

Database.cs

此方法使用 SQL 语句为数据库下的容器创建查询。 它返回 FeedIterator。

public abstract Microsoft.Azure.Cosmos.FeedIterator<T> GetContainerQueryIterator<T> (string queryText = default, string continuationToken = default, Microsoft.Azure.Cosmos.QueryRequestOptions requestOptions = default);

abstract member GetContainerQueryIterator : string * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator<'T>

Public MustOverride Function GetContainerQueryIterator(Of T) (Optional queryText As String = Nothing, Optional continuationToken As String = Nothing, Optional requestOptions As QueryRequestOptions = Nothing) As FeedIterator(Of T)

类型参数

T

参数

queryText

String

Cosmos SQL 查询文本。

continuationToken

String

(可选) Azure Cosmos DB 服务中的延续令牌。

requestOptions

QueryRequestOptions

(可选) 项查询请求的选项。

返回

FeedIterator<T>

用于遍历容器的迭代器

示例

1. 这会为容器创建类型源迭代器，并将 queryText 作为输入，

string queryText = "SELECT * FROM c where c.status like 'start%'";
using (FeedIterator<ContainerProperties> feedIterator = this.cosmosDatabase.GetContainerQueryIterator<ContainerProperties>(queryText))
{
    while (feedIterator.HasMoreResults)
    {
        FeedResponse<ContainerProperties> response = await feedIterator.ReadNextAsync();
        foreach (var container in response)
        {
            Console.WriteLine(container);
        }
    }
}

2. 这会为不带 queryText 的容器创建类型源迭代器，从而检索所有容器。

using (FeedIterator<ContainerProperties> feedIterator = this.cosmosDatabase.GetContainerQueryIterator<ContainerProperties>())
{
    while (feedIterator.HasMoreResults)
    {
        FeedResponse<ContainerProperties> response = await feedIterator.ReadNextAsync();
        foreach (var container in response)
        {
           Console.WriteLine(container);
        }
    }
}

注解

有关语法和示例， https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started 请参阅 。

ReadContainerAsync(ContainerRequestOptions, CancellationToken) 建议用于单容器查找。