RequestOptions.AccessCondition Eigenschaft

Referenz

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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Bedingung (ETag) ab, die der Anforderung im Azure Cosmos DB-Dienst zugeordnet ist, oder legt sie fest.

public Microsoft.Azure.Documents.Client.AccessCondition AccessCondition { get; set; }

member this.AccessCondition : Microsoft.Azure.Documents.Client.AccessCondition with get, set

Public Property AccessCondition As AccessCondition

Eigenschaftswert

AccessCondition

Die Bedingung (ETag), die der Anforderung zugeordnet ist.

Beispiele

Das folgende Beispiel zeigt, wie RequestOptions mit ReplaceDocumentAsync(String, Object, RequestOptions, CancellationToken) verwendet wird, um den Satz von anzugeben, der AccessCondition beim Aktualisieren eines Dokuments verwendet werden soll.

// If ETag is current, then this will succeed. Otherwise the request will fail with HTTP 412 Precondition Failure
await client.ReplaceDocumentAsync(
    readCopyOfBook.SelfLink,
    new Book { Title = "Moby Dick", Price = 14.99 },
    new RequestOptions
    {
        AccessCondition = new AccessCondition
        {
            Condition = readCopyOfBook.ETag,
            Type = AccessConditionType.IfMatch
        }
     });

Hinweise

Wird am häufigsten mit den Methoden Delete* und Replace* von DocumentClient wie oder ReplaceDocumentAsync(String, Object, RequestOptions, CancellationToken)ReplaceDocumentAsync(Document, RequestOptions, CancellationToken) verwendet, kann jedoch mit anderen Methoden verwendet werden, z. BReadDocumentAsync(String, RequestOptions, CancellationToken). für Zwischenspeicherungsszenarien.

Gilt für:

Freigeben über