IDocumentClient.ReadDocumentCollectionFeedAsync Methode

Definition

Namespace:

Microsoft.Azure.Documents

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 (Sequenz) von DocumentCollection für eine Datenbank aus dem Azure Cosmos DB-Dienst als asynchronen Vorgang.
ReadDocumentCollectionFeedAsync(Uri, FeedOptions)	Liest den Feed (Sequenz) von Sammlungen für eine Datenbank als asynchronen Vorgang im Azure Cosmos DB-Dienst.

ReadDocumentCollectionFeedAsync(String, FeedOptions)

Liest den Feed (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>>

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. Z.B. /dbs/db_rid/colls/

options

FeedOptions

(Optional) Die Anforderungsoptionen für die Anforderung.

Gibt zurück

Task<FeedResponse<DocumentCollection>>

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

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, sind:

StatusCode	Ausnahmegrund
404	NotFound: Dies bedeutet, dass der Ressourcenfeed, den Sie lesen möchten, nicht vorhanden war. Überprüfen Sie, ob die übergeordneten Rids richtig sind.
429	TooManyRequests: Dies bedeutet, dass Sie die Anzahl der Anforderungseinheiten pro Sekunde überschritten haben. Lesen Sie den Wert DocumentClientException.RetryAfter, um zu ermitteln, 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

• ResourceResponse<TResource>
• Task
• DocumentCollection
• RequestOptions

ReadDocumentCollectionFeedAsync(Uri, FeedOptions)

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

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

Parameter

databaseUri

Uri

Der URI der übergeordneten Datenbank.

options

FeedOptions

(Optional) Der FeedOptions für die Anforderung.

Gibt zurück

Task<FeedResponse<DocumentCollection>>

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