RequestOptions.AccessCondition Propiedad

Definición

Espacio de nombres:

Microsoft.Azure.Documents.Client

Ensamblados:

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

Paquetes:

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

Obtiene o establece la condición (ETag) asociada a la solicitud en el servicio 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 de propiedad

AccessCondition

Condición (ETag) asociada a la solicitud.

Ejemplos

En el ejemplo siguiente se muestra cómo usar RequestOptions con ReplaceDocumentAsync(String, Object, RequestOptions, CancellationToken) para especificar el conjunto de AccessCondition que se va a usar al actualizar un 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
        }
     });

Comentarios

Se usa normalmente con los métodos Delete* y Replace* de DocumentClient , como ReplaceDocumentAsync(Document, RequestOptions, CancellationToken) o ReplaceDocumentAsync(String, Object, RequestOptions, CancellationToken) , pero se puede usar con otros métodos como ReadDocumentAsync(String, RequestOptions, CancellationToken) para escenarios de almacenamiento en caché.