RequestOptions.AccessCondition Propriedade

Definição

Namespace:

Microsoft.Azure.Documents.Client

Assemblies:

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

Pacotes:

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

Obtém ou define a condição (ETag) associada à solicitação no serviço do Azure Cosmos DB.

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

Valor da propriedade

AccessCondition

A condição (ETag) associada à solicitação.

Exemplos

O exemplo a seguir mostra como usar RequestOptions com ReplaceDocumentAsync(String, Object, RequestOptions, CancellationToken) para especificar o conjunto de AccessCondition a ser usado ao atualizar um documento

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

Comentários

Mais comumente usado com os métodos Delete* e Replace* de DocumentClient , como ReplaceDocumentAsync(Document, RequestOptions, CancellationToken) ou ReplaceDocumentAsync(String, Object, RequestOptions, CancellationToken) métodos, mas pode ser usado com outros métodos como ReadDocumentAsync(String, RequestOptions, CancellationToken) para cenários de cache.