CosmosContainer.ReplaceItemAsync<T> Método

Definición

Espacio de nombres:

Azure.Cosmos

Ensamblado:

Azure.Cosmos.dll

Paquete:

Azure.Cosmos v4.0.0-preview3

Reemplaza un elemento del servicio Azure Cosmos como una operación asincrónica.

public abstract System.Threading.Tasks.Task<Azure.Cosmos.ItemResponse<T>> ReplaceItemAsync<T> (T item, string id, Azure.Cosmos.PartitionKey? partitionKey = default, Azure.Cosmos.ItemRequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member ReplaceItemAsync : 'T * string * Nullable<Azure.Cosmos.PartitionKey> * Azure.Cosmos.ItemRequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Cosmos.ItemResponse<'T>>

Public MustOverride Function ReplaceItemAsync(Of T) (item As T, id As String, Optional partitionKey As Nullable(Of PartitionKey) = Nothing, Optional requestOptions As ItemRequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ItemResponse(Of T))

Parámetros de tipo

T

Parámetros

item

T

Objeto serializable JSON que debe contener una propiedad id. CosmosSerializer para implementar un serializador personalizado.

id

String

Identificador del elemento de Cosmos, que se espera que coincida con el valor de T.

partitionKey

Nullable<PartitionKey>

Clave de partición para el elemento. Si no se especifica, se rellenará extrayendo de {T}

requestOptions

ItemRequestOptions

(Opcional) Las opciones de la solicitud de elemento ItemRequestOptions

cancellationToken

CancellationToken

(Opcional) CancellationToken que representa la cancelación de la solicitud.

Devoluciones

Task<ItemResponse<T>>

que Task contiene un Response<T> objeto que encapsula el registro de recursos actualizado.

Excepciones

ArgumentNullException

Si no se establece ninguna item de las dos opciones.

CosmosException

Esta excepción puede encapsular muchos tipos diferentes de errores. Para determinar el error específico, examine siempre la propiedad StatusCode.

StatusCode	Motivo de la excepción
400	BadRequest: esto significa que algo estaba mal con el documento proporcionado.
403	Prohibido: esto probablemente significa que la colección en la que estaba intentando crear el documento está llena.
413	RequestEntityTooLarge: esto significa que el elemento supera el tamaño máximo de entidad actual. Consulte la documentación para conocer los límites y las cuotas.
429	TooManyRequests: esto significa que ha superado el número de unidades de solicitud por segundo.

Ejemplos

public class ToDoActivity{
    public string id {get; set;}
    public string status {get; set;}
}

ToDoActivity test = new ToDoActivity()
{
   id = Guid.NewGuid().ToString(),
   status = "InProgress"
};

ItemResponse<ToDoActivity> item = await this.container.ReplaceItemAsync<ToDoActivity>(test, test.id, new PartitionKey(test.status));