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

Database.GetUserQueryIterator 方法

定义

命名空间:

Microsoft.Azure.Cosmos

程序集:

Microsoft.Azure.Cosmos.Client.dll

包:

Microsoft.Azure.Cosmos v3.39.0

重载

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

GetUserQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)

Source:

Database.cs

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

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

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

Public MustOverride Function GetUserQueryIterator(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<UserProperties> resultSet = this.cosmosDatabase.GetUserQueryIterator<UserProperties>(queryDefinition))
{
    while (feedIterator.HasMoreResults)
    {
        foreach (UserProperties properties in await feedIterator.ReadNextAsync())
        {
            Console.WriteLine(properties.Id);
        }
    }
}

GetUserQueryIterator<T>(String, String, QueryRequestOptions)

Source:

Database.cs

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

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

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

Public MustOverride Function GetUserQueryIterator(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<UserProperties> HasMoreResults = this.cosmosDatabase.GetUserQueryIterator<UserProperties>(queryText))
{
    while (feedIterator.HasMoreResults)
    {
        FeedResponse<UserProperties> response = await feedIterator.ReadNextAsync();
        foreach (var user in response)
        {
            Console.WriteLine(user);
        }
    }
}

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

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