IReliableDictionary<TKey,TValue>.TryGetValueAsync Método
Definição
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
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
Azure SDK for .NET
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários