Partager via


IReliableDictionary<TKey,TValue>.AddOrUpdateAsync Méthode

Définition

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

Task<TValue>

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

Task<TValue>

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

Task<TValue>

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

Task<TValue>

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 à