Compartilhar via


IReliableDictionary<TKey,TValue>.TryGetValueAsync Método

Definição

Sobrecargas

TryGetValueAsync(ITransaction, TKey)

Tenta obter o valor associado à chave especificada do Dicionário Confiável.

TryGetValueAsync(ITransaction, TKey, LockMode)

Tenta obter o valor associado à chave especificada do Dicionário Confiável.

TryGetValueAsync(ITransaction, TKey, TimeSpan, CancellationToken)

Tenta obter o valor associado à chave especificada do Dicionário Confiável.

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

Tenta obter o valor associado à chave especificada do Dicionário Confiável.

TryGetValueAsync(ITransaction, TKey)

Tenta obter o valor associado à chave especificada do Dicionário Confiável.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<TValue>> TryGetValueAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key);
abstract member TryGetValueAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<'Value>>
Public Function TryGetValueAsync (tx As ITransaction, key As TKey) As Task(Of ConditionalValue(Of TValue))

Parâmetros

tx
ITransaction

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

key
TKey

A chave do valor 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, em caso afirmativo, o valor.

Exceções

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

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

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

TryGetValueAsync(ITransaction, TKey, LockMode)

Tenta obter o valor associado à chave especificada do Dicionário Confiável.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<TValue>> TryGetValueAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Microsoft.ServiceFabric.Data.Collections.LockMode lockMode);
abstract member TryGetValueAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Microsoft.ServiceFabric.Data.Collections.LockMode -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<'Value>>
Public Function TryGetValueAsync (tx As ITransaction, key As TKey, lockMode As LockMode) As Task(Of ConditionalValue(Of TValue))

Parâmetros

tx
ITransaction

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

key
TKey

A chave do valor 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, em caso afirmativo, o valor.

Exceções

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

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

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

TryGetValueAsync(ITransaction, TKey, TimeSpan, CancellationToken)

Tenta obter o valor associado à chave especificada do Dicionário Confiável.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<TValue>> TryGetValueAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
abstract member TryGetValueAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<'Value>>
Public Function TryGetValueAsync (tx As ITransaction, key As TKey, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ConditionalValue(Of TValue))

Parâmetros

tx
ITransaction

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

key
TKey

A chave do valor a ser obtido.

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, em caso afirmativo, o valor.

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

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

Tenta obter o valor associado à chave especificada do Dicionário Confiável.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<TValue>> TryGetValueAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Microsoft.ServiceFabric.Data.Collections.LockMode lockMode, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
abstract member TryGetValueAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Microsoft.ServiceFabric.Data.Collections.LockMode * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<'Value>>
Public Function TryGetValueAsync (tx As ITransaction, key As TKey, lockMode As LockMode, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ConditionalValue(Of TValue))

Parâmetros

tx
ITransaction

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

key
TKey

A chave do valor 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, em caso afirmativo, o valor.

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