IReliableDictionary<TKey,TValue>.AddOrUpdateAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| AddOrUpdateAsync(ITransaction, TKey, Func<TKey,TValue>, Func<TKey,TValue,TValue>) |
Utilise les fonctions spécifiées pour ajouter une paire clé/valeur au dictionnaire fiable si la clé n’existe pas déjà, ou pour mettre à jour une paire clé/valeur dans le dictionnaire fiable si la clé existe déjà. |
| AddOrUpdateAsync(ITransaction, TKey, TValue, Func<TKey,TValue,TValue>) |
Ajoute une paire clé/valeur au dictionnaire fiable si la clé n’existe pas déjà, ou met à jour une paire clé/valeur dans le dictionnaire fiable à l’aide de la fonction spécifiée si la clé existe déjà. |
| AddOrUpdateAsync(ITransaction, TKey, Func<TKey,TValue>, Func<TKey,TValue,TValue>, TimeSpan, CancellationToken) |
Utilise les fonctions spécifiées pour ajouter une paire clé/valeur au dictionnaire fiable si la clé n’existe pas déjà, ou pour mettre à jour une paire clé/valeur dans le dictionnaire fiable si la clé existe déjà. |
| AddOrUpdateAsync(ITransaction, TKey, TValue, Func<TKey,TValue,TValue>, TimeSpan, CancellationToken) |
Ajoute une paire clé/valeur au dictionnaire fiable si la clé n’existe pas déjà, ou met à jour une paire clé/valeur dans le dictionnaire fiable à l’aide de la fonction spécifiée si la clé existe déjà. |
AddOrUpdateAsync(ITransaction, TKey, Func<TKey,TValue>, Func<TKey,TValue,TValue>)
Utilise les fonctions spécifiées pour ajouter une paire clé/valeur au dictionnaire fiable si la clé n’existe pas déjà, ou pour mettre à jour une paire clé/valeur dans le dictionnaire fiable si la clé existe déjà.
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)Paramètres
- tx
- ITransaction
Transaction à laquelle associer cette opération.
- key
- TKey
Clé à ajouter ou dont la valeur doit être mise à jour.
- addValueFactory
- Func<TKey,TValue>
Fonction utilisée pour générer une valeur pour une clé absente.
- updateValueFactory
- Func<TKey,TValue,TValue>
Fonction utilisée pour générer une nouvelle valeur pour une clé existante en fonction de la valeur existante de la clé.
Retours
Tâche qui représente l’opération d’ajout ou de mise à jour asynchrone. Le résultat de la tâche est la nouvelle valeur de la clé. Il s’agit du résultat de addValueFactory (si la clé était absente) ou du résultat de updateValueFactory (si la clé était présente).
Exceptions
tx a la valeur null, ou key est null ou ne peut pas être sérialisé, ou addValueFactory est null, ou updateValueFactory est null.
L’opération n’a pas pu se terminer dans le délai d’attente par défaut.
Exception levée lorsque le IReliableDictionary<TKey,TValue> n’est pas dans Primary.
La transaction a été défaillante en interne par le système. Réessayez l’opération sur une nouvelle transaction
Levée lorsqu’un appel de méthode n’est pas valide pour l’état actuel de l’objet. Par exemple, la transaction utilisée est déjà terminée : validée ou abandonnée par l’utilisateur. Si cette exception est levée, il est fort probable qu’il y ait un bogue dans le code de service de l’utilisation des transactions.
Indique que le dictionnaire fiable est fermé ou supprimé.
S’applique à
AddOrUpdateAsync(ITransaction, TKey, TValue, Func<TKey,TValue,TValue>)
Ajoute une paire clé/valeur au dictionnaire fiable si la clé n’existe pas déjà, ou met à jour une paire clé/valeur dans le dictionnaire fiable à l’aide de la fonction spécifiée si la clé existe déjà.
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)Paramètres
- tx
- ITransaction
Transaction à laquelle associer cette opération.
- key
- TKey
Clé à ajouter ou dont la valeur doit être mise à jour.
- addValue
- TValue
Valeur à ajouter pour une clé absente. La valeur peut être null pour les types référence.
- updateValueFactory
- Func<TKey,TValue,TValue>
Fonction utilisée pour générer une nouvelle valeur pour une clé existante en fonction de la valeur existante de la clé.
Retours
Tâche qui représente l’opération d’ajout ou de mise à jour asynchrone. Le résultat de la tâche est la nouvelle valeur de la clé. Il s’agit de addValue (si la clé était absente) ou du résultat de updateValueFactory (si la clé était présente).
Exceptions
tx a la valeur null, ou key est null ou ne peut pas être sérialisé, ou updateValueFactory est null.
L’opération n’a pas pu se terminer dans le délai d’attente par défaut.
Exception levée lorsque le IReliableDictionary<TKey,TValue> n’est pas dans Primary.
La transaction a été défaillante en interne par le système. Réessayez l’opération sur une nouvelle transaction
Levée lorsqu’un appel de méthode n’est pas valide pour l’état actuel de l’objet. Par exemple, la transaction utilisée est déjà terminée : validée ou abandonnée par l’utilisateur. Si cette exception est levée, il est fort probable qu’il y ait un bogue dans le code de service de l’utilisation des transactions.
Indique que le dictionnaire fiable est fermé ou supprimé.
S’applique à
AddOrUpdateAsync(ITransaction, TKey, Func<TKey,TValue>, Func<TKey,TValue,TValue>, TimeSpan, CancellationToken)
Utilise les fonctions spécifiées pour ajouter une paire clé/valeur au dictionnaire fiable si la clé n’existe pas déjà, ou pour mettre à jour une paire clé/valeur dans le dictionnaire fiable si la clé existe déjà.
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)Paramètres
- tx
- ITransaction
Transaction à laquelle associer cette opération.
- key
- TKey
Clé à ajouter ou dont la valeur doit être mise à jour.
- addValueFactory
- Func<TKey,TValue>
Fonction utilisée pour générer une valeur pour une clé absente.
- updateValueFactory
- Func<TKey,TValue,TValue>
Fonction utilisée pour générer une nouvelle valeur pour une clé existante en fonction de la valeur existante de la clé.
- timeout
- TimeSpan
Durée d’attente de la fin de l’opération avant de lever une timeoutException. Principalement utilisé pour éviter les interblocages. La valeur par défaut est de 4 secondes.
- cancellationToken
- CancellationToken
Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est Aucun.
Retours
Tâche qui représente l’opération d’ajout ou de mise à jour asynchrone. Le résultat de la tâche est la nouvelle valeur de la clé. Il s’agit du résultat de addValueFactory (si la clé était absente) ou du résultat de updateValueFactory (si la clé était présente).
Exceptions
tx a la valeur null, ou key est null ou ne peut pas être sérialisé, ou addValueFactory est null, ou updateValueFactory est null.
timeout est un nombre négatif.
L’opération n’a pas pu se terminer dans le délai donné.
L'opération a été annulée.
Exception levée lorsque le IReliableDictionary<TKey,TValue> n’est pas dans Primary.
La transaction a été défaillante en interne par le système. Réessayez l’opération sur une nouvelle transaction
Levée lorsqu’un appel de méthode n’est pas valide pour l’état actuel de l’objet. Par exemple, la transaction utilisée est déjà terminée : validée ou abandonnée par l’utilisateur. Si cette exception est levée, il est fort probable qu’il y ait un bogue dans le code de service de l’utilisation des transactions.
Indique que le dictionnaire fiable est fermé ou supprimé.
S’applique à
AddOrUpdateAsync(ITransaction, TKey, TValue, Func<TKey,TValue,TValue>, TimeSpan, CancellationToken)
Ajoute une paire clé/valeur au dictionnaire fiable si la clé n’existe pas déjà, ou met à jour une paire clé/valeur dans le dictionnaire fiable à l’aide de la fonction spécifiée si la clé existe déjà.
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)Paramètres
- tx
- ITransaction
Transaction à laquelle associer cette opération.
- key
- TKey
Clé à ajouter ou dont la valeur doit être mise à jour.
- addValue
- TValue
Valeur à ajouter pour une clé absente. La valeur peut être null pour les types référence.
- updateValueFactory
- Func<TKey,TValue,TValue>
Fonction utilisée pour générer une nouvelle valeur pour une clé existante en fonction de la valeur existante de la clé.
- timeout
- TimeSpan
Durée d’attente de la fin de l’opération avant de lever une timeoutException. Principalement utilisé pour éviter les interblocages. La valeur par défaut est de 4 secondes.
- cancellationToken
- CancellationToken
Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est Aucun.
Retours
Tâche qui représente l’opération d’ajout ou de mise à jour asynchrone. Le résultat de la tâche est la nouvelle valeur de la clé. Il s’agit de addValue (si la clé était absente) ou du résultat de updateValueFactory (si la clé était présente).
Exceptions
tx a la valeur null, ou key est null ou ne peut pas être sérialisé, ou updateValueFactory est null.
timeout est un nombre négatif.
L’opération n’a pas pu se terminer dans le délai donné.
L'opération a été annulée.
Exception levée lorsque le IReliableDictionary<TKey,TValue> n’est pas dans Primary.
La transaction a été défaillante en interne par le système. Réessayez l’opération sur une nouvelle transaction
Levée lorsqu’un appel de méthode n’est pas valide pour l’état actuel de l’objet. Par exemple, la transaction utilisée est déjà terminée : validée ou abandonnée par l’utilisateur. Si cette exception est levée, il est fort probable qu’il y ait un bogue dans le code de service de l’utilisation des transactions.
Indique que le dictionnaire fiable est fermé ou supprimé.
S’applique à
Azure SDK for .NET