IReliableDictionary<TKey,TValue>.TryUpdateAsync Método

Definición

Espacio de nombres:

Microsoft.ServiceFabric.Data.Collections

Ensamblado:

Microsoft.ServiceFabric.Data.Interfaces.dll

Paquete:

Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

Sobrecargas

TryUpdateAsync(ITransaction, TKey, TValue, TValue)	Compara el valor existente de la clave especificada con el valor especificado y, si son iguales, actualiza la clave con un tercer valor.
TryUpdateAsync(ITransaction, TKey, TValue, TValue, TimeSpan, CancellationToken)	Compara el valor existente de la clave especificada con el valor especificado y, si son iguales, actualiza la clave con un tercer valor.

TryUpdateAsync(ITransaction, TKey, TValue, TValue)

Compara el valor existente de la clave especificada con el valor especificado y, si son iguales, actualiza la clave con un tercer valor.

public System.Threading.Tasks.Task<bool> TryUpdateAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue newValue, TValue comparisonValue);

abstract member TryUpdateAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * 'Value -> System.Threading.Tasks.Task<bool>

Public Function TryUpdateAsync (tx As ITransaction, key As TKey, newValue As TValue, comparisonValue As TValue) As Task(Of Boolean)

Parámetros

tx

ITransaction

Transacción con la que asociar esta operación.

key

TKey

Clave cuyo valor se compara con comparisonValue y posiblemente se reemplaza.

newValue

TValue

Valor que reemplaza el valor del elemento que ha especificado key si al compararlos se determina que son iguales.

comparisonValue

TValue

Valor que se compara con el valor del elemento que tiene el especificado key.

Devoluciones

Task<Boolean>

Tarea que representa la operación de actualización asincrónica. El resultado de la tarea indica si el objeto se actualizó.

Excepciones

ArgumentNullException

tx es null, o key es null o no se puede serializar.

TimeoutException

No se pudo completar la operación dentro del tiempo de espera predeterminado.

FabricNotPrimaryException

Excepción que se produce cuando no IReliableDictionary<TKey,TValue> está en Primary.

TransactionFaultedException

El sistema ha producido un error interno en la transacción. Reintentar la operación en una nueva transacción

InvalidOperationException

Se produce cuando una llamada de método no es válida para el estado actual del objeto. Por ejemplo, la transacción usada ya ha finalizado: el usuario la ha confirmado o anulado. Si se produce esta excepción, es muy probable que haya un error en el código de servicio del uso de transacciones.

FabricObjectClosedException

Indica que el diccionario confiable está cerrado o eliminado.

TryUpdateAsync(ITransaction, TKey, TValue, TValue, TimeSpan, CancellationToken)

Compara el valor existente de la clave especificada con el valor especificado y, si son iguales, actualiza la clave con un tercer valor.

public System.Threading.Tasks.Task<bool> TryUpdateAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue newValue, TValue comparisonValue, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

abstract member TryUpdateAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * 'Value * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Function TryUpdateAsync (tx As ITransaction, key As TKey, newValue As TValue, comparisonValue As TValue, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of Boolean)

Parámetros

tx

ITransaction

Transacción con la que asociar esta operación.

key

TKey

Clave cuyo valor se compara con comparisonValue y posiblemente se reemplaza.

newValue

TValue

Valor que reemplaza el valor del elemento que ha especificado key si al compararlos se determina que son iguales.

comparisonValue

TValue

Valor que se compara con el valor del elemento que tiene el especificado key.

timeout

TimeSpan

Cantidad de tiempo que se debe esperar a que se complete la operación antes de iniciar timeoutException. Se usa principalmente para evitar interbloqueos. El valor predeterminado es de 4 segundos.

cancellationToken

CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es none.

Devoluciones

Task<Boolean>

Tarea que representa la operación de actualización asincrónica. El resultado de la tarea indica si el objeto se actualizó.

Excepciones

ArgumentNullException

tx es null, o key es null o no se puede serializar.

ArgumentException

timeout es negativo.

TimeoutException

No se pudo completar la operación dentro del tiempo de espera especificado.

OperationCanceledException

Operación cancelada.

FabricNotPrimaryException

Excepción que se produce cuando no IReliableDictionary<TKey,TValue> está en Primary.

TransactionFaultedException

El sistema ha producido un error interno en la transacción. Reintentar la operación en una nueva transacción

InvalidOperationException

Se produce cuando una llamada de método no es válida para el estado actual del objeto. Por ejemplo, la transacción usada ya ha finalizado: el usuario la ha confirmado o anulado. Si se produce esta excepción, es muy probable que haya un error en el código de servicio del uso de transacciones.

FabricObjectClosedException

Indica que el diccionario confiable está cerrado o eliminado.