你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Database.GetContainerQueryIterator 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| 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
(可选) 项查询请求的选项。
返回
用于遍历容器的迭代器
示例
这将创建类型源迭代器，用于将 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
(可选) 项查询请求的选项。
返回
用于遍历容器的迭代器
示例
- 这会为容器创建类型源迭代器，并将 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);
}
}
}
- 这会为不带 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) 建议用于单容器查找。
