IReliableQueue<T>.TryDequeueAsync 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

TryDequeueAsync(ITransaction)	Tente de supprimer et de retourner l’objet au début de la file d’attente fiable.
TryDequeueAsync(ITransaction, TimeSpan, CancellationToken)	Tente de supprimer et de retourner l’objet au début de la file d’attente fiable.

TryDequeueAsync(ITransaction)

Tente de supprimer et de retourner l’objet au début de la file d’attente fiable.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<T>> TryDequeueAsync (Microsoft.ServiceFabric.Data.ITransaction tx);

abstract member TryDequeueAsync : Microsoft.ServiceFabric.Data.ITransaction -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<'T>>

Public Function TryDequeueAsync (tx As ITransaction) As Task(Of ConditionalValue(Of T))

Paramètres

tx

ITransaction

Transaction à laquelle associer cette opération.

Retours

Task<ConditionalValue<T>>

Tâche qui représente l’opération de déqueue asynchrone. Le résultat de la tâche est un tuple indiquant si un objet a été supprimé et, le cas échéant, l’objet .

Exceptions

ArgumentNullException

tx a la valeur null.

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 n’est pas dans .

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.

Remarques

Si une exception retriable est levée par cette méthode, il est recommandé de supprimer la transaction tx et de réessayer avec une nouvelle transaction.

TryDequeueAsync(ITransaction, TimeSpan, CancellationToken)

Tente de supprimer et de retourner l’objet au début de la file d’attente fiable.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<T>> TryDequeueAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

abstract member TryDequeueAsync : Microsoft.ServiceFabric.Data.ITransaction * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<'T>>

Public Function TryDequeueAsync (tx As ITransaction, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ConditionalValue(Of T))

Paramètres

tx

ITransaction

Transaction à laquelle associer cette opération.

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<ConditionalValue<T>>

Tâche qui représente l’opération de déqueue asynchrone. Le résultat de la tâche est un tuple indiquant si un objet a été supprimé et, le cas échéant, l’objet .

Exceptions

ArgumentNullException

tx a la valeur null.

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 n’est pas dans .

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.

Remarques

Si une exception retriable est levée par cette méthode, il est recommandé de supprimer la transaction tx et de réessayer avec une nouvelle transaction.