IReliableDictionary<TKey,TValue>.GetOrAddAsync 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
| GetOrAddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken) |
Adiciona um par chave/valor ao Dicionário Confiável se a chave ainda não existir. |
| GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>, TimeSpan, CancellationToken) |
Adiciona um par chave/valor ao Dicionário Confiável usando a função especificada, se a chave ainda não existir. |
| GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>) |
Adiciona um par chave/valor ao Dicionário Confiável usando a função especificada, se a chave ainda não existir. |
| GetOrAddAsync(ITransaction, TKey, TValue) |
Adiciona um par chave/valor ao Dicionário Confiável se a chave ainda não existir. Se a chave existir, nenhuma atualização será feita no valor . |
GetOrAddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)
Adiciona um par chave/valor ao Dicionário Confiável se a chave ainda não existir.
public System.Threading.Tasks.Task<TValue> GetOrAddAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue value, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Value>Public Function GetOrAddAsync (tx As ITransaction, key As TKey, value As TValue, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of TValue)Parâmetros
- tx
- ITransaction
Transação à qual associar essa operação.
- key
- TKey
A chave do elemento a ser adicionada.
- value
- TValue
O valor a ser adicionado se a chave ainda não existir.
- 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 adição assíncrona. O resultado da tarefa é o valor da chave. Esse será o valor existente para a chave se a chave já estiver no Dicionário Confiável ou o novo valor se a chave não estiver no Dicionário Confiável.
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.
A exceção que é gerada quando o IReliableDictionary<TKey,TValue> não está em Primary.
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
GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>, TimeSpan, CancellationToken)
Adiciona um par chave/valor ao Dicionário Confiável usando a função especificada, se a chave ainda não existir.
public System.Threading.Tasks.Task<TValue> GetOrAddAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Func<TKey,TValue> valueFactory, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Func<'Key, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)> * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Value>Public Function GetOrAddAsync (tx As ITransaction, key As TKey, valueFactory As Func(Of TKey, TValue), timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of TValue)Parâmetros
- tx
- ITransaction
Transação à qual associar essa operação.
- key
- TKey
A chave do elemento a ser adicionada.
- valueFactory
- Func<TKey,TValue>
A função usada para gerar um valor para a chave.
- 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 adição assíncrona. O resultado da tarefa é o valor da chave. Esse será o valor existente para a chave se a chave já estiver no Dicionário Confiável ou o novo valor da chave, conforme retornado por valueFactory, se a chave não estiver no Dicionário Confiável.
Exceções
tx é nulo ou key é nulo ou não pode ser serializado ou valueFactory é nulo.
timeout é negativo.
Falha ao concluir a operação dentro do tempo limite especificado.
A operação foi cancelada.
A exceção que é gerada quando o IReliableDictionary<TKey,TValue> não está em Primary.
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
GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>)
Adiciona um par chave/valor ao Dicionário Confiável usando a função especificada, se a chave ainda não existir.
public System.Threading.Tasks.Task<TValue> GetOrAddAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Func<TKey,TValue> valueFactory);abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Func<'Key, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)> -> System.Threading.Tasks.Task<'Value>Public Function GetOrAddAsync (tx As ITransaction, key As TKey, valueFactory As Func(Of TKey, TValue)) As Task(Of TValue)Parâmetros
- tx
- ITransaction
Transação à qual associar essa operação.
- key
- TKey
A chave do elemento a ser adicionada.
- valueFactory
- Func<TKey,TValue>
A função usada para gerar um valor para a chave.
Retornos
Uma tarefa que representa a operação de adição assíncrona. O resultado da tarefa é o valor da chave. Esse será o valor existente para a chave se a chave já estiver no Dicionário Confiável ou o novo valor da chave, conforme retornado por valueFactory, se a chave não estiver no Dicionário Confiável.
Exceções
tx é nulo ou key é nulo ou não pode ser serializado ou valueFactory é nulo.
Falha ao concluir a operação dentro do tempo limite padrão.
A exceção que é gerada quando o IReliableDictionary<TKey,TValue> não está em Primary.
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
GetOrAddAsync(ITransaction, TKey, TValue)
Adiciona um par chave/valor ao Dicionário Confiável se a chave ainda não existir. Se a chave existir, nenhuma atualização será feita no valor .
public System.Threading.Tasks.Task<TValue> GetOrAddAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue value);abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value -> System.Threading.Tasks.Task<'Value>Public Function GetOrAddAsync (tx As ITransaction, key As TKey, value As TValue) As Task(Of TValue)Parâmetros
- tx
- ITransaction
Transação à qual associar essa operação.
- key
- TKey
A chave do elemento a ser adicionada.
- value
- TValue
O valor a ser adicionado se a chave ainda não existir.
Retornos
Uma tarefa que representa a operação de adição assíncrona. O resultado da tarefa é o valor da chave. Esse será o valor existente para a chave se a chave já estiver no Dicionário Confiável ou o novo valor se a chave não estiver no Dicionário Confiável.
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.
A exceção que é gerada quando o IReliableDictionary<TKey,TValue> não está em Primary.
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