IReliableDictionary<TKey,TValue>.TryUpdateAsync Méthode

Définition

Espace de noms:

Microsoft.ServiceFabric.Data.Collections

Assembly:

Microsoft.ServiceFabric.Data.Interfaces.dll

Paquet:

Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

Surcharges

TryUpdateAsync(ITransaction, TKey, TValue, TValue)	Compare la valeur existante pour la clé spécifiée avec une valeur spécifiée, et si elles sont égales, met à jour la clé avec une troisième valeur.
TryUpdateAsync(ITransaction, TKey, TValue, TValue, TimeSpan, CancellationToken)	Compare la valeur existante pour la clé spécifiée avec une valeur spécifiée, et si elles sont égales, met à jour la clé avec une troisième valeur.

TryUpdateAsync(ITransaction, TKey, TValue, TValue)

Compare la valeur existante pour la clé spécifiée avec une valeur spécifiée, et si elles sont égales, met à jour la clé avec une troisième valeur.

public System.Threading.Tasks.Task<bool> TryUpdateAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue newValue, TValue comparisonValue);

abstract member TryUpdateAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * 'Value -> System.Threading.Tasks.Task<bool>

Public Function TryUpdateAsync (tx As ITransaction, key As TKey, newValue As TValue, comparisonValue As TValue) As Task(Of Boolean)

Paramètres

tx

ITransaction

Transaction à laquelle associer cette opération.

key

TKey

Clé dont la valeur est comparée comparisonValue à et éventuellement remplacée.

newValue

TValue

Valeur qui remplace la valeur de l'élément comportant la key spécifiée si la comparaison conclut à une égalité.

comparisonValue

TValue

Valeur comparée à la valeur de l’élément qui a le spécifié key.

Retours

Task<Boolean>

Tâche qui représente l’opération de mise à jour asynchrone. Le résultat de la tâche indique si l’objet a été mis à jour.

Exceptions

ArgumentNullException

tx a la valeur null ou key est null ou ne peut pas être sérialisé.

TimeoutException

L’opération n’a pas pu se terminer dans le délai d’attente par défaut.

FabricNotPrimaryException

Exception levée lorsque le IReliableDictionary<TKey,TValue> n’est pas dans Primary.

TransactionFaultedException

La transaction a été défaillante en interne par le système. Réessayez l’opération sur une nouvelle transaction

InvalidOperationException

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.

FabricObjectClosedException

Indique que le dictionnaire fiable est fermé ou supprimé.

TryUpdateAsync(ITransaction, TKey, TValue, TValue, TimeSpan, CancellationToken)

Compare la valeur existante pour la clé spécifiée avec une valeur spécifiée, et si elles sont égales, met à jour la clé avec une troisième valeur.

public System.Threading.Tasks.Task<bool> TryUpdateAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue newValue, TValue comparisonValue, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

abstract member TryUpdateAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * 'Value * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Function TryUpdateAsync (tx As ITransaction, key As TKey, newValue As TValue, comparisonValue As TValue, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of Boolean)

Paramètres

tx

ITransaction

Transaction à laquelle associer cette opération.

key

TKey

Clé dont la valeur est comparée comparisonValue à et éventuellement remplacée.

newValue

TValue

Valeur qui remplace la valeur de l'élément comportant la key spécifiée si la comparaison conclut à une égalité.

comparisonValue

TValue

Valeur comparée à la valeur de l’élément qui a le spécifié key.

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<Boolean>

Tâche qui représente l’opération de mise à jour asynchrone. Le résultat de la tâche indique si l’objet a été mis à jour.

Exceptions

ArgumentNullException

tx a la valeur null ou key est null ou ne peut pas être sérialisé.

ArgumentException

timeout est un nombre négatif.

TimeoutException

L’opération n’a pas pu se terminer dans le délai donné.

OperationCanceledException

L'opération a été annulée.

FabricNotPrimaryException

Exception levée lorsque le IReliableDictionary<TKey,TValue> n’est pas dans Primary.

TransactionFaultedException

La transaction a été défaillante en interne par le système. Réessayez l’opération sur une nouvelle transaction

InvalidOperationException

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.

FabricObjectClosedException

Indique que le dictionnaire fiable est fermé ou supprimé.