DocumentClient.ReadDocumentFeedAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| ReadDocumentFeedAsync(String, FeedOptions, CancellationToken) |
Lee la fuente (secuencia) de documentos de una colección especificada del servicio Azure Cosmos DB. Esto toma devuelve un ResourceResponse<TResource> objeto que contendrá una lista enumerable de objetos dinámicos. |
| ReadDocumentFeedAsync(Uri, FeedOptions, CancellationToken) |
Lee la fuente (secuencia) de documentos de una colección como una operación asincrónica desde el servicio Azure Cosmos DB. |
ReadDocumentFeedAsync(String, FeedOptions, CancellationToken)
Lee la fuente (secuencia) de documentos de una colección especificada del servicio Azure Cosmos DB. Esto toma devuelve un ResourceResponse<TResource> objeto que contendrá una lista enumerable de objetos dinámicos.
public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.FeedResponse<dynamic>> ReadDocumentFeedAsync (string documentsLink, Microsoft.Azure.Documents.Client.FeedOptions options = default, System.Threading.CancellationToken cancellationToken = default);abstract member ReadDocumentFeedAsync : string * Microsoft.Azure.Documents.Client.FeedOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.FeedResponse<obj>>
override this.ReadDocumentFeedAsync : string * Microsoft.Azure.Documents.Client.FeedOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.FeedResponse<obj>>Public Function ReadDocumentFeedAsync (documentsLink As String, Optional options As FeedOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of FeedResponse(Of Object))Parámetros
- documentsLink
- String
SelfLink de los recursos que se van a leer. Por ejemplo, /dbs/db_rid/colls/coll_rid/docs/
- options
- FeedOptions
(Opcional) Las opciones de solicitud de la solicitud.
- cancellationToken
- CancellationToken
(Opcional) que CancellationToken pueden ser utilizados por otros objetos o subprocesos para recibir aviso de cancelación.
Devoluciones
que System.Threading.Tasks contiene un objeto ResourceResponse<TResource> que contiene objetos dinámicos que representan los elementos de la fuente.
Implementaciones
Excepciones
Si documentsLink no se establece.
Esta excepción puede encapsular muchos tipos diferentes de errores. Para determinar el error específico, examine siempre la propiedad StatusCode. Algunos códigos comunes que puede obtener al crear un documento son:
| StatusCode | Motivo de la excepción |
|---|---|
| 404 | NotFound: significa que la fuente de recursos que intentó leer no existía. Compruebe que los rid primarios son correctos. |
| 429 | TooManyRequests: esto significa que ha superado el número de unidades de solicitud por segundo. Consulte el valor DocumentClientException.RetryAfter para ver cuánto tiempo debe esperar antes de volver a intentar esta operación. |
Ejemplos
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<dynamic> response = await client.ReadDocumentFeedAsync("/dbs/db_rid/colls/coll_rid/docs/",
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));
Comentarios
En lugar de FeedResponse{Document} este método aprovecha los objetos dinámicos en .NET. De este modo, un único resultado de fuente puede contener cualquier tipo de documento o objeto POCO. Esto es importante que un DocumentCollection pueda contener diferentes tipos de documentos.
Consulte también
Se aplica a
ReadDocumentFeedAsync(Uri, FeedOptions, CancellationToken)
Lee la fuente (secuencia) de documentos de una colección como una operación asincrónica desde el servicio Azure Cosmos DB.
public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.FeedResponse<dynamic>> ReadDocumentFeedAsync (Uri documentsUri, Microsoft.Azure.Documents.Client.FeedOptions options = default, System.Threading.CancellationToken cancellationToken = default);abstract member ReadDocumentFeedAsync : Uri * Microsoft.Azure.Documents.Client.FeedOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.FeedResponse<obj>>
override this.ReadDocumentFeedAsync : Uri * Microsoft.Azure.Documents.Client.FeedOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.FeedResponse<obj>>Public Function ReadDocumentFeedAsync (documentsUri As Uri, Optional options As FeedOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of FeedResponse(Of Object))Parámetros
- documentsUri
- Uri
el URI de los documentos.
- options
- FeedOptions
Las opciones de solicitud de la solicitud.
- cancellationToken
- CancellationToken
(Opcional) CancellationToken que representa la cancelación de la solicitud.
Devoluciones
Objeto de tarea que representa la respuesta del servicio para la operación asincrónica.
Implementaciones
Se aplica a
Azure SDK for .NET