IReliableDictionary3<TKey,TValue>.TryUpdateAsync Méthode

Définition

Espace de noms:

Microsoft.ServiceFabric.Data.Collections.Beta

Assembly:

Microsoft.ServiceFabric.Data.Interfaces.V2.dll

Paquet:

Microsoft.ServiceFabric.Data.Interfaces.V2 v6.1.1583

Surcharges

TryUpdateAsync(ITransaction, TKey, TValue, Int64)	(Bêta) Tente de mettre à jour la valeur de la clé spécifiée, étant donné que le numéro de séquence correspond.
TryUpdateAsync(ITransaction, TKey, TValue, Int64, TimeSpan, CancellationToken)	(Bêta) Tente de mettre à jour la valeur de la clé spécifiée, étant donné que le numéro de séquence correspond.

TryUpdateAsync(ITransaction, TKey, TValue, Int64)

(Bêta) Tente de mettre à jour la valeur de la clé spécifiée, étant donné que le numéro de séquence correspond.

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

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

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

Paramètres

tx

ITransaction

Transaction à laquelle associer cette opération.

key

TKey

Clé de l’élément à mettre à jour.

newValue

TValue

Valeur à mettre à jour si le spécifié key a le attendu checkSequenceNumber.

checkSequenceNumber

Int64

Numéro de séquence attendu de l’élément à mettre à jour.

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 est 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’expiration par défaut.

FabricNotPrimaryException

Exception levée lorsque n’est IReliableDictionary<TKey,TValue> 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 très 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, Int64, TimeSpan, CancellationToken)

(Bêta) Tente de mettre à jour la valeur de la clé spécifiée, étant donné que le numéro de séquence correspond.

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

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

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

Paramètres

tx

ITransaction

Transaction à laquelle associer cette opération.

key

TKey

Clé de l’élément à mettre à jour.

newValue

TValue

Valeur à mettre à jour si le spécifié key a le attendu checkSequenceNumber.

checkSequenceNumber

Int64

Numéro de séquence attendu de l’élément à mettre à jour.

timeout

TimeSpan

Délai d’attente de la fin de l’opération avant de lever une exception 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 est 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’expiration par défaut.

FabricNotPrimaryException

Exception levée lorsque n’est IReliableDictionary<TKey,TValue> 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 très 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é.