Compartilhar via


IReliableDictionary3<TKey,TValue>.TryGetVersionedKeyValuePairAsync Método

Definição

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

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

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

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

A operação foi cancelada.

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.

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

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.

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

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

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

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

A operação foi cancelada.

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.

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

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.

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.

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

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

timeout é negativo.

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

A operação foi cancelada.

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.

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

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.

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

Aplica-se a