IReliableDictionary3<TKey,TValue>.TryGetVersionedKeyValuePairAsync Método

Referência

Definição

Namespace:: Microsoft.ServiceFabric.Data.Collections.Beta

Assembly:: Microsoft.ServiceFabric.Data.Interfaces.V2.dll

Pacote:: Microsoft.ServiceFabric.Data.Interfaces.V2 v6.1.1583

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

TryGetVersionedKeyValuePairAsync(ITransaction, TKey)	(Beta) Tenta obter o elemento com controle de versão associado à chave especificada do Dicionário Confiável.
TryGetVersionedKeyValuePairAsync(ITransaction, TKey, LockMode)	(Beta) Tenta obter o elemento com controle de versão associado à chave especificada do Dicionário Confiável.
TryGetVersionedKeyValuePairAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken)	(Beta) Tenta obter o elemento com controle de versão associado à chave especificada do Dicionário Confiável.

TryGetVersionedKeyValuePairAsync(ITransaction, TKey)

(Beta) Tenta obter o elemento com controle de versão associado à chave especificada do Dicionário Confiável.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<TKey,TValue>>> TryGetVersionedKeyValuePairAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key);

abstract member TryGetVersionedKeyValuePairAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<'Key, 'Value>>>

Public Function TryGetVersionedKeyValuePairAsync (tx As ITransaction, key As TKey) As Task(Of ConditionalValue(Of VersionedKeyValuePair(Of TKey, TValue)))

Parâmetros

tx: ITransaction

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

key: TKey

A chave do elemento com controle de versão a ser obtido.

Retornos

Task<ConditionalValue<VersionedKeyValuePair<TKey,TValue>>>

Uma tarefa que representa a operação de leitura assíncrona. O resultado da tarefa é uma tupla que indica se a chave foi encontrada no Dicionário Confiável e, se encontrada, o valor e o número de sequência.

Exceções

ArgumentNullException

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

TimeoutException

Falha ao concluir a operação dentro do tempo limite especificado.

OperationCanceledException

A operação foi cancelada.

FabricNotReadableException

Indica que o IReliableDictionary não pode servir leituras no momento. Essa exceção pode ser gerada em todos os ReplicaRoles. Um motivo pelo qual ele pode ser lançado na função é a Primary perda de ReadStatus. Um motivo pelo qual ele pode ser lançado na função é que o ActiveSecondary estado da Coleção Confiável ainda não é consistente.

TransactionFaultedException

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

InvalidOperationException

Gerada 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.

Aplica-se a

TryGetVersionedKeyValuePairAsync(ITransaction, TKey, LockMode)

(Beta) Tenta obter o elemento com controle de versão associado à chave especificada do Dicionário Confiável.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<TKey,TValue>>> TryGetVersionedKeyValuePairAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Microsoft.ServiceFabric.Data.Collections.LockMode lockMode);

abstract member TryGetVersionedKeyValuePairAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Microsoft.ServiceFabric.Data.Collections.LockMode -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<'Key, 'Value>>>

Public Function TryGetVersionedKeyValuePairAsync (tx As ITransaction, key As TKey, lockMode As LockMode) As Task(Of ConditionalValue(Of VersionedKeyValuePair(Of TKey, TValue)))

Parâmetros

tx: ITransaction

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

key: TKey

A chave do elemento com controle de versão a ser obtido.

lockMode: LockMode

Tipo de bloqueio a ser usado para esta operação de leitura.

Retornos

Task<ConditionalValue<VersionedKeyValuePair<TKey,TValue>>>

Exceções

ArgumentNullException

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

TimeoutException

Falha ao concluir a operação dentro do tempo limite especificado.

OperationCanceledException

A operação foi cancelada.

FabricNotReadableException

TransactionFaultedException

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

InvalidOperationException

FabricObjectClosedException

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

Aplica-se a

TryGetVersionedKeyValuePairAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken)

(Beta) Tenta obter o elemento com controle de versão associado à chave especificada do Dicionário Confiável.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<TKey,TValue>>> TryGetVersionedKeyValuePairAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Microsoft.ServiceFabric.Data.Collections.LockMode lockMode, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

abstract member TryGetVersionedKeyValuePairAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Microsoft.ServiceFabric.Data.Collections.LockMode * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<'Key, 'Value>>>

Public Function TryGetVersionedKeyValuePairAsync (tx As ITransaction, key As TKey, lockMode As LockMode, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ConditionalValue(Of VersionedKeyValuePair(Of TKey, TValue)))

Parâmetros

tx: ITransaction

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

key: TKey

A chave do elemento com controle de versão a ser obtido.

lockMode: LockMode

Tipo de bloqueio a ser usado para esta operação de leitura.

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.