Freigeben über

IDocumentClient.ReadConflictAsync Methode

  • Referenz

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

ReadConflictAsync(Uri, RequestOptions)

Liest einen Conflict als asynchronen Vorgang aus dem Azure Cosmos DB-Dienst.
ReadConflictAsync(String, RequestOptions)

Liest einen Conflict aus dem Azure Cosmos DB-Dienst als asynchronen Vorgang.

ReadConflictAsync(Uri, RequestOptions)

Liest einen Conflict als asynchronen Vorgang aus dem Azure Cosmos DB-Dienst.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Conflict>> ReadConflictAsync (Uri conflictUri, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member ReadConflictAsync : Uri * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Conflict>>
Public Function ReadConflictAsync (conflictUri As Uri, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of Conflict))

Parameter

conflictUri
Uri

Ein URI für die Konfliktressource, die gelesen werden soll.

options
RequestOptions

Die Anforderungsoptionen für die Anforderung.

Gibt zurück

Task<ResourceResponse<Conflict>>

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

Ausnahmen

ArgumentNullException

Wenn conflictUri 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:

StatusCodeAusnahmegrund
404NotFound: Dies bedeutet, dass die Ressource, die Sie lesen möchten, nicht vorhanden war.
429TooManyRequests: 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

//Reads a Conflict resource where 
// - db_id is the ID property of the Database
// - coll_id is the ID property of the DocumentCollection
// - conflict_id is the ID property of the Conflict you wish to read. 
var conflictLink = UriFactory.CreateConflictUri("db_id", "coll_id", "conflict_id");
Conflict conflict = await client.ReadConflictAsync(conflictLink);

Hinweise

Das Lesen einer Ressource ist die effizienteste Möglichkeit, eine Ressource aus dem Dienst abzurufen. Wenn Sie die ID der Ressource kennen, führen Sie anstelle einer Abfrage nach ID einen Lesevorgang durch.

Weitere Informationen

Gilt für:

ReadConflictAsync(String, RequestOptions)

Liest einen Conflict aus dem Azure Cosmos DB-Dienst als asynchronen Vorgang.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Conflict>> ReadConflictAsync (string conflictLink, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member ReadConflictAsync : string * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Conflict>>
Public Function ReadConflictAsync (conflictLink As String, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of Conflict))

Parameter

conflictLink
String

Der Link zum zu lesenden Konflikt.

options
RequestOptions

(Optional) Die Anforderungsoptionen für die Anforderung.

Gibt zurück

Task<ResourceResponse<Conflict>>

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

Ausnahmen

ArgumentNullException

Wenn conflictLink 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:

StatusCodeAusnahmegrund
404NotFound: Dies bedeutet, dass die Ressource, die Sie lesen möchten, nicht vorhanden war.
429TooManyRequests: 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

//Reads a Conflict resource from a Database
// - sample_database is the ID of the database
// - sample_collection is the ID of the collection
// - conflict_id is the ID of the conflict to be read
var conflictLink = "/dbs/sample_database/colls/sample_collection/conflicts/conflict_id";
Conflict conflict = await client.ReadConflictAsync(conflictLink);

Hinweise

Das Lesen einer Ressource ist die effizienteste Methode, um eine Ressource aus der Datenbank abzurufen. Wenn Sie die ID der Ressource kennen, führen Sie anstelle einer Abfrage nach ID einen Lesevorgang durch.

Das gezeigte Beispiel verwendet ID-basierte Links, wobei der Link aus den ID-Eigenschaften besteht, die beim Erstellen der Ressourcen verwendet wurden. Sie können weiterhin die SelfLink -Eigenschaft der Conflict-Eigenschaft verwenden, wenn Sie möchten. Eine Selbstverknüpfung ist ein URI für eine Ressource, die aus Ressourcenbezeichnern (oder den _rid Eigenschaften) besteht. ID-basierte Links und SelfLink funktionieren beide. Das Format für conflictLink ist immer "/dbs/{db identifier}/colls/{collectioon identifier}/conflicts/{conflict identifier}", nur die Werte innerhalb des {...}-Werts ändern sich je nachdem, welche Methode Sie zum Adressieren der Ressource verwenden möchten.

Weitere Informationen

Gilt für: