IReliableDictionary<TKey,TValue>.AddOrUpdateAsync 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
| AddOrUpdateAsync(ITransaction, TKey, Func<TKey,TValue>, Func<TKey,TValue,TValue>) |
Usa as funções especificadas para adicionar um par chave/valor ao Dicionário Confiável se a chave ainda não existir ou para atualizar um par chave/valor no Dicionário Confiável se a chave já existir. |
| AddOrUpdateAsync(ITransaction, TKey, TValue, Func<TKey,TValue,TValue>) |
Adiciona um par chave/valor ao Dicionário Confiável se a chave ainda não existir ou atualiza um par chave/valor no Dicionário Confiável usando a função especificada se a chave já existir. |
| AddOrUpdateAsync(ITransaction, TKey, Func<TKey,TValue>, Func<TKey,TValue,TValue>, TimeSpan, CancellationToken) |
Usa as funções especificadas para adicionar um par chave/valor ao Dicionário Confiável se a chave ainda não existir ou para atualizar um par chave/valor no Dicionário Confiável se a chave já existir. |
| AddOrUpdateAsync(ITransaction, TKey, TValue, Func<TKey,TValue,TValue>, TimeSpan, CancellationToken) |
Adiciona um par chave/valor ao Dicionário Confiável se a chave ainda não existir ou atualiza um par chave/valor no Dicionário Confiável usando a função especificada se a chave já existir. |
AddOrUpdateAsync(ITransaction, TKey, Func<TKey,TValue>, Func<TKey,TValue,TValue>)
Usa as funções especificadas para adicionar um par chave/valor ao Dicionário Confiável se a chave ainda não existir ou para atualizar um par chave/valor no Dicionário Confiável se a chave já existir.
public System.Threading.Tasks.Task<TValue> AddOrUpdateAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Func<TKey,TValue> addValueFactory, Func<TKey,TValue,TValue> updateValueFactory);abstract member AddOrUpdateAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Func<'Key, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)> * Func<'Key, 'Value, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)> -> System.Threading.Tasks.Task<'Value>Public Function AddOrUpdateAsync (tx As ITransaction, key As TKey, addValueFactory As Func(Of TKey, TValue), updateValueFactory As Func(Of TKey, TValue, TValue)) As Task(Of TValue)Parâmetros
- tx
- ITransaction
Transação à qual associar essa operação.
- key
- TKey
A chave a ser adicionada ou cujo valor deve ser atualizado.
- addValueFactory
- Func<TKey,TValue>
A função usada para gerar um valor para uma chave ausente.
- updateValueFactory
- Func<TKey,TValue,TValue>
A função usada para gerar um novo valor para uma chave existente com base no valor existente da chave.
Retornos
Tarefa que representa a operação assíncrona de adição ou atualização. O resultado da tarefa é o novo valor da chave. Isso será o resultado de addValueFactory (se a chave estiver ausente) ou o resultado de updateValueFactory (se a chave estiver presente).
Exceções
tx é nulo ou key é nulo ou não pode ser serializado ou addValueFactory é nulo ou updateValueFactory é 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
AddOrUpdateAsync(ITransaction, TKey, TValue, Func<TKey,TValue,TValue>)
Adiciona um par chave/valor ao Dicionário Confiável se a chave ainda não existir ou atualiza um par chave/valor no Dicionário Confiável usando a função especificada se a chave já existir.
public System.Threading.Tasks.Task<TValue> AddOrUpdateAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue addValue, Func<TKey,TValue,TValue> updateValueFactory);abstract member AddOrUpdateAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * Func<'Key, 'Value, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)> -> System.Threading.Tasks.Task<'Value>Public Function AddOrUpdateAsync (tx As ITransaction, key As TKey, addValue As TValue, updateValueFactory As Func(Of TKey, TValue, TValue)) As Task(Of TValue)Parâmetros
- tx
- ITransaction
Transação à qual associar essa operação.
- key
- TKey
A chave a ser adicionada ou cujo valor deve ser atualizado.
- addValue
- TValue
O valor a ser adicionado para uma chave ausente. O valor pode ser nulo para tipos de referência.
- updateValueFactory
- Func<TKey,TValue,TValue>
A função usada para gerar um novo valor para uma chave existente com base no valor existente da chave.
Retornos
Tarefa que representa a operação assíncrona de adição ou atualização. O resultado da tarefa é o novo valor da chave. Isso será addValue (se a chave estiver ausente) ou o resultado de updateValueFactory (se a chave estiver presente).
Exceções
tx é nulo ou key é nulo ou não pode ser serializado ou updateValueFactory é 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
AddOrUpdateAsync(ITransaction, TKey, Func<TKey,TValue>, Func<TKey,TValue,TValue>, TimeSpan, CancellationToken)
Usa as funções especificadas para adicionar um par chave/valor ao Dicionário Confiável se a chave ainda não existir ou para atualizar um par chave/valor no Dicionário Confiável se a chave já existir.
public System.Threading.Tasks.Task<TValue> AddOrUpdateAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Func<TKey,TValue> addValueFactory, Func<TKey,TValue,TValue> updateValueFactory, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);abstract member AddOrUpdateAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Func<'Key, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)> * Func<'Key, 'Value, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)> * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Value>Public Function AddOrUpdateAsync (tx As ITransaction, key As TKey, addValueFactory As Func(Of TKey, TValue), updateValueFactory As Func(Of TKey, TValue, 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 a ser adicionada ou cujo valor deve ser atualizado.
- addValueFactory
- Func<TKey,TValue>
A função usada para gerar um valor para uma chave ausente.
- updateValueFactory
- Func<TKey,TValue,TValue>
A função usada para gerar um novo valor para uma chave existente com base no valor existente da 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
Tarefa que representa a operação assíncrona de adição ou atualização. O resultado da tarefa é o novo valor da chave. Isso será o resultado de addValueFactory (se a chave estiver ausente) ou o resultado de updateValueFactory (se a chave estiver presente).
Exceções
tx é nulo ou key é nulo ou não pode ser serializado ou addValueFactory é nulo ou updateValueFactory é 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
AddOrUpdateAsync(ITransaction, TKey, TValue, Func<TKey,TValue,TValue>, TimeSpan, CancellationToken)
Adiciona um par chave/valor ao Dicionário Confiável se a chave ainda não existir ou atualiza um par chave/valor no Dicionário Confiável usando a função especificada se a chave já existir.
public System.Threading.Tasks.Task<TValue> AddOrUpdateAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue addValue, Func<TKey,TValue,TValue> updateValueFactory, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);abstract member AddOrUpdateAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * Func<'Key, 'Value, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)> * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Value>Public Function AddOrUpdateAsync (tx As ITransaction, key As TKey, addValue As TValue, updateValueFactory As Func(Of TKey, TValue, 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 a ser adicionada ou cujo valor deve ser atualizado.
- addValue
- TValue
O valor a ser adicionado para uma chave ausente. O valor pode ser nulo para tipos de referência.
- updateValueFactory
- Func<TKey,TValue,TValue>
A função usada para gerar um novo valor para uma chave existente com base no valor existente da 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
Tarefa que representa a operação assíncrona de adição ou atualização. O resultado da tarefa é o novo valor da chave. Isso será addValue (se a chave estiver ausente) ou o resultado de updateValueFactory (se a chave estiver presente).
Exceções
tx é nulo ou key é nulo ou não pode ser serializado ou updateValueFactory é 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
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