IDocumentClient.ReadDocumentCollectionFeedAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.Documents

Assemblys:

Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll

Paquets:

Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.0

Surcharges

ReadDocumentCollectionFeedAsync(String, FeedOptions)	Lit le flux (séquence) d’une base de DocumentCollection données à partir du service Azure Cosmos DB en tant qu’opération asynchrone.
ReadDocumentCollectionFeedAsync(Uri, FeedOptions)	Lit le flux (séquence) de collections pour une base de données en tant qu’opération asynchrone dans le service Azure Cosmos DB.

ReadDocumentCollectionFeedAsync(String, FeedOptions)

Lit le flux (séquence) d’une base de DocumentCollection données à partir du service Azure Cosmos DB en tant qu’opération asynchrone.

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))

Paramètres

collectionsLink

String

SelfLink des ressources à lire. Par exemple /dbs/db_rid/colls/

options

FeedOptions

(Facultatif) Options de demande pour la demande.

Retours

Task<FeedResponse<DocumentCollection>>

System.Threading.Tasks contenant un ResourceResponse<TResource> qui encapsule un DocumentCollection contenant l’enregistrement de ressource de lecture.

Exceptions

ArgumentNullException

Si collectionsLink n’est pas défini.

DocumentClientException

Cette exception peut encapsuler de nombreux types d’erreurs différents. Pour déterminer l’erreur spécifique, examinez toujours la propriété StatusCode. Voici quelques codes courants que vous pouvez obtenir lors de la création d’un document :

StatusCode	Raison de l’exception
404	NotFound : cela signifie que le flux de ressources que vous avez tenté de lire n’existait pas. Vérifiez que les rids parent sont corrects.
429	TooManyRequests : cela signifie que vous avez dépassé le nombre d’unités de requête par seconde. Consultez la valeur DocumentClientException.RetryAfter pour savoir combien de temps vous devez attendre avant de réessayer cette opération.

Exemples

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));

Voir aussi

• DocumentCollection
• RequestOptions
• ResourceResponse<TResource>
• Task

ReadDocumentCollectionFeedAsync(Uri, FeedOptions)

Lit le flux (séquence) de collections pour une base de données en tant qu’opération asynchrone dans le service 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))

Paramètres

databaseUri

Uri

URI de la base de données parente.

options

FeedOptions

(Facultatif) FeedOptions pour la demande.

Retours

Task<FeedResponse<DocumentCollection>>

Objet de tâche représentant la réponse du service pour l’opération asynchrone.