IReliableDictionary<TKey,TValue>.TryUpdateAsync Método

Definição

Namespace:

Microsoft.ServiceFabric.Data.Collections

Assembly:

Microsoft.ServiceFabric.Data.Interfaces.dll

Pacote:

Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

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

Task<Boolean>

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

Exceções

ArgumentNullException

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

TimeoutException

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

FabricNotPrimaryException

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

TransactionFaultedException

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

InvalidOperationException

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.

FabricObjectClosedException

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

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

Task<Boolean>

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

Exceções

ArgumentNullException

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

ArgumentException

timeout é negativo.

TimeoutException

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

OperationCanceledException

A operação foi cancelada.

FabricNotPrimaryException

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

TransactionFaultedException

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

InvalidOperationException

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.

FabricObjectClosedException

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