DocumentClient.ReadDocumentCollectionFeedAsync Methode

Definition

Namespace:

Microsoft.Azure.Documents.Client

Assemblys:

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

Pakete:

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

Überlädt

ReadDocumentCollectionFeedAsync(String, FeedOptions)	Liest den Feed (die Sequenz) von DocumentCollection für eine Datenbank aus dem Azure Cosmos DB-Dienst als asynchronen Vorgang.
ReadDocumentCollectionFeedAsync(Uri, FeedOptions)	Liest den Feed (die Sequenz) von Sammlungen für eine Datenbank als asynchronen Vorgang aus dem Azure Cosmos DB-Dienst.

ReadDocumentCollectionFeedAsync(String, FeedOptions)

Liest den Feed (die Sequenz) von DocumentCollection für eine Datenbank aus dem Azure Cosmos DB-Dienst als asynchronen Vorgang.

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>>
override this.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))

Parameter

collectionsLink

String

Der SelfLink der zu lesenden Ressourcen. Beispiel: /dbs/db_rid/colls/

options

FeedOptions

(Optional) Die Anforderungsoptionen für die Anforderung.

Gibt zurück

Task<FeedResponse<DocumentCollection>>

Eine System.Threading.Tasks , die ein ResourceResponse<TResource> enthält, das einen DocumentCollection umschließt, der den gelesenen Ressourcendatensatz enthält.

Implementiert

ReadDocumentCollectionFeedAsync(String, FeedOptions)

Ausnahmen

ArgumentNullException

Wenn collectionsLink nicht festgelegt ist.

DocumentClientException

Diese Ausnahme kann viele verschiedene Fehlertypen kapseln. Um den spezifischen Fehler zu ermitteln, sehen Sie sich immer die StatusCode-Eigenschaft an. Einige häufige Codes, die Sie beim Erstellen eines Dokuments erhalten können, sind:

StatusCode	Grund für die Ausnahme
404	NotFound: Dies bedeutet, dass der Ressourcenfeed, den Sie lesen möchten, nicht vorhanden war. Überprüfen Sie, ob die übergeordneten Rids korrekt sind.
429	TooManyRequests: Dies bedeutet, dass Sie die Anzahl der Anforderungseinheiten pro Sekunde überschritten haben. Lesen Sie den DocumentClientException.RetryAfter-Wert, um zu sehen, wie lange Sie warten sollten, bevor Sie diesen Vorgang wiederholen.

Beispiele

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

Weitere Informationen

• DocumentCollection
• RequestOptions
• ResourceResponse<TResource>
• Task

ReadDocumentCollectionFeedAsync(Uri, FeedOptions)

Liest den Feed (die Sequenz) von Sammlungen für eine Datenbank als asynchronen Vorgang aus dem Azure Cosmos DB-Dienst.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.FeedResponse<Microsoft.Azure.Documents.DocumentCollection>> ReadDocumentCollectionFeedAsync (Uri documentCollectionsUri, 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>>
override this.ReadDocumentCollectionFeedAsync : Uri * Microsoft.Azure.Documents.Client.FeedOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.FeedResponse<Microsoft.Azure.Documents.DocumentCollection>>

Public Function ReadDocumentCollectionFeedAsync (documentCollectionsUri As Uri, Optional options As FeedOptions = Nothing) As Task(Of FeedResponse(Of DocumentCollection))

Parameter

documentCollectionsUri

Uri

der URI für die Dokumentauflistungen.

options

FeedOptions

Die Anforderungsoptionen für die Anforderung.

Gibt zurück

Task<FeedResponse<DocumentCollection>>

Das Aufgabenobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt.

Implementiert

ReadDocumentCollectionFeedAsync(Uri, FeedOptions)