Compartilhar via


IReliableDictionary<TKey,TValue>.TryUpdateAsync Método

Definição

Sobrecargas

TryUpdateAsync(ITransaction, TKey, TValue, TValue)

Compara o valor existente para a chave especificada com um valor especificado e se eles forem iguais, atualiza a chave com um terceiro valor.

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

Compara o valor existente para a chave especificada com um valor especificado e se eles forem iguais, atualiza a chave com um terceiro valor.

TryUpdateAsync(ITransaction, TKey, TValue, TValue)

Compara o valor existente para a chave especificada com um valor especificado e se eles forem iguais, atualiza a chave com um terceiro 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

Transação à qual associar essa operação.

key
TKey

A chave cujo valor é comparado com comparisonValue e possivelmente substituído.

newValue
TValue

O valor que substitui o valor do elemento que foi especificado key se a comparação resulta em igualdade.

comparisonValue
TValue

O valor é comparado com o valor do elemento que foi especificado key.

Retornos

Uma tarefa que representa a operação de atualização assíncrona. O resultado da tarefa indica se o objeto foi atualizado.

Exceções

tx é nulo ou key é nulo ou não pode ser serializado.

A operação não foi concluída dentro do tempo limite padrão.

A exceção gerada quando o IReliableDictionary<TKey,TValue> não está em Primary.

A transação foi falha interna do sistema. Repetir a operação em uma nova transação

Gerado quando uma chamada de método é inválida para o estado atual do objeto. Por exemplo, a transação usada já foi encerrada: confirmada ou anulada pelo usuário. Se essa exceção for gerada, é altamente provável que haja um bug no código de serviço do uso de transações.

Indica que o Dicionário Confiável está fechado ou excluído.

Aplica-se a

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

Compara o valor existente para a chave especificada com um valor especificado e se eles forem iguais, atualiza a chave com um terceiro 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

Transação à qual associar essa operação.

key
TKey

A chave cujo valor é comparado com comparisonValue e possivelmente substituído.

newValue
TValue

O valor que substitui o valor do elemento que foi especificado key se a comparação resulta em igualdade.

comparisonValue
TValue

O valor é comparado com o valor do elemento que foi especificado key.

timeout
TimeSpan

A quantidade de tempo para aguardar a conclusão da operação antes de lançar um TimeoutException. Usado principalmente para evitar deadlocks. O padrão é 4 segundos.

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento. A opção padrão é Nenhum.

Retornos

Uma tarefa que representa a operação de atualização assíncrona. O resultado da tarefa indica se o objeto foi atualizado.

Exceções

tx é nulo ou key é nulo ou não pode ser serializado.

timeout é negativo.

A operação não foi concluída dentro do tempo limite especificado.

A operação foi cancelada.

A exceção gerada quando o IReliableDictionary<TKey,TValue> não está em Primary.

A transação foi falha interna do sistema. Repetir a operação em uma nova transação

Gerado quando uma chamada de método é inválida para o estado atual do objeto. Por exemplo, a transação usada já foi encerrada: confirmada ou anulada pelo usuário. Se essa exceção for gerada, é altamente provável que haja um bug no código de serviço do uso de transações.

Indica que o Dicionário Confiável está fechado ou excluído.

Aplica-se a