IDocumentClient.ReadDocumentCollectionFeedAsync Método

  • Referência

Definição

Namespace:
Microsoft.Azure.Documents
Assemblies:
Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll
Pacotes:
Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.0

Sobrecargas

ReadDocumentCollectionFeedAsync(String, FeedOptions)

Lê o feed (sequência) de para DocumentCollection um banco de dados do serviço do Azure Cosmos DB como uma operação assíncrona.
ReadDocumentCollectionFeedAsync(Uri, FeedOptions)

Lê o feed (sequência) de coleções de um banco de dados como uma operação assíncrona no serviço do Azure Cosmos DB.

ReadDocumentCollectionFeedAsync(String, FeedOptions)

Lê o feed (sequência) de para DocumentCollection um banco de dados do serviço do Azure Cosmos DB como uma operação assíncrona.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.FeedResponse<Microsoft.Azure.Documents.DocumentCollection>> ReadDocumentCollectionFeedAsync (string collectionsLink, Microsoft.Azure.Documents.Client.FeedOptions options = default);
abstract member ReadDocumentCollectionFeedAsync : string * Microsoft.Azure.Documents.Client.FeedOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.FeedResponse<Microsoft.Azure.Documents.DocumentCollection>>
Public Function ReadDocumentCollectionFeedAsync (collectionsLink As String, Optional options As FeedOptions = Nothing) As Task(Of FeedResponse(Of DocumentCollection))

Parâmetros

collectionsLink
String

O SelfLink dos recursos a serem lidos. Por exemplo, /dbs/db_rid/colls/

options
FeedOptions

(Opcional) As opções de solicitação para a solicitação.

Retornos

Task<FeedResponse<DocumentCollection>>

Um System.Threading.Tasks que contém um ResourceResponse<TResource> que encapsula um DocumentCollection que contém o registro de recurso de leitura.

Exceções

ArgumentNullException

Se collectionsLink não estiver definido.

DocumentClientException

Essa exceção pode encapsular muitos tipos diferentes de erros. Para determinar o erro específico, sempre examine a propriedade StatusCode. Alguns códigos comuns que você pode obter ao criar um Documento são:

StatusCodeMotivo da exceção
404NotFound - Isso significa que o feed de recursos que você tentou ler não existia. Verifique se os rids pai estão corretos.
429TooManyRequests - Isso significa que você excedeu o número de unidades de solicitação por segundo. Consulte o valor DocumentClientException.RetryAfter para ver quanto tempo você deve aguardar antes de repetir essa operação.

Exemplos

int count = 0;
string continuation = string.Empty;
do
{
    // Read the feed 10 items at a time until there are no more items to read
    FeedResponse<DocumentCollection> response = await client.ReadDocumentCollectionFeedAsync("/dbs/db_rid/colls/",
                                                    new FeedOptions
                                                    {
                                                        MaxItemCount = 10,
                                                        RequestContinuation = continuation
                                                    });

    // Append the item count
    count += response.Count;

    // Get the continuation so that we know when to stop.
     continuation = response.ResponseContinuation;
} while (!string.IsNullOrEmpty(continuation));

Confira também

Aplica-se a

ReadDocumentCollectionFeedAsync(Uri, FeedOptions)

Lê o feed (sequência) de coleções de um banco de dados como uma operação assíncrona no serviço do Azure Cosmos DB.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.FeedResponse<Microsoft.Azure.Documents.DocumentCollection>> ReadDocumentCollectionFeedAsync (Uri databaseUri, Microsoft.Azure.Documents.Client.FeedOptions options = default);
abstract member ReadDocumentCollectionFeedAsync : Uri * Microsoft.Azure.Documents.Client.FeedOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.FeedResponse<Microsoft.Azure.Documents.DocumentCollection>>
Public Function ReadDocumentCollectionFeedAsync (databaseUri As Uri, Optional options As FeedOptions = Nothing) As Task(Of FeedResponse(Of DocumentCollection))

Parâmetros

databaseUri
Uri

O URI do banco de dados pai.

options
FeedOptions

(Opcional) O FeedOptions para a solicitação.

Retornos

Task<FeedResponse<DocumentCollection>>

O objeto de tarefa que representa a resposta de serviço para a operação assíncrona.

Aplica-se a