IReliableDictionary<TKey,TValue>.TryGetValueAsync Método

Referência

Definição

Namespace:: Microsoft.ServiceFabric.Data.Collections

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

Pacote:: Microsoft.ServiceFabric.Data.Interfaces 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

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

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

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 padrão.

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

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

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

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 padrão.

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

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

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

Exceções

ArgumentNullException

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

ArgumentException

timeout é negativo.

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

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

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