IReliableDictionary<TKey,TValue>.TryAddAsync Méthode

Référence

Définition

Espace de noms:: Microsoft.ServiceFabric.Data.Collections

Assembly:: Microsoft.ServiceFabric.Data.Interfaces.dll

Paquet:: Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

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

TryAddAsync(ITransaction, TKey, TValue)	Tente d’ajouter la clé et la valeur spécifiées au dictionnaire fiable.
TryAddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)	Tente d’ajouter la clé et la valeur spécifiées au dictionnaire fiable.

TryAddAsync(ITransaction, TKey, TValue)

Tente d’ajouter la clé et la valeur spécifiées au dictionnaire fiable.

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

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

Public Function TryAddAsync (tx As ITransaction, key As TKey, value As TValue) As Task(Of Boolean)

Paramètres

tx: ITransaction

Transaction à laquelle associer cette opération.

key: TKey

Clé de l'élément à ajouter.

value: TValue

Valeur de l'élément à ajouter. La valeur peut être null pour les types référence.

Retours

Task<Boolean>

Tâche qui représente l’opération d’ajout asynchrone. Le résultat de la tâche indique si la paire clé/valeur a été ajoutée.

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é.

S’applique à

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

Tente d’ajouter la clé et la valeur spécifiées au dictionnaire fiable.

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

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

Public Function TryAddAsync (tx As ITransaction, key As TKey, value 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é de l'élément à ajouter.

value: TValue

Valeur de l'élément à ajouter. La valeur peut être null pour les types référence.

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.