IReliableQueue<T>.TryDequeueAsync Methode

Definition

Namespace:

Microsoft.ServiceFabric.Data.Collections

Assembly:

Microsoft.ServiceFabric.Data.Interfaces.dll

Paket:

Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

Überlädt

TryDequeueAsync(ITransaction)	Versucht, das Objekt am Anfang der zuverlässigen Warteschlange zu entfernen und zurückzugeben.
TryDequeueAsync(ITransaction, TimeSpan, CancellationToken)	Versucht, das Objekt am Anfang der zuverlässigen Warteschlange zu entfernen und zurückzugeben.

TryDequeueAsync(ITransaction)

Versucht, das Objekt am Anfang der zuverlässigen Warteschlange zu entfernen und zurückzugeben.

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

Parameter

tx

ITransaction

Transaktion, der dieser Vorgang zugeordnet werden soll.

Gibt zurück

Task<ConditionalValue<T>>

Aufgabe, die den asynchronen Vorgang des Ausqueues darstellt. Das Aufgabenergebnis ist ein Tupel, das angibt, ob ein Objekt entfernt wurde, und wenn ja, das Objekt.

Ausnahmen

ArgumentNullException

tx ist NULL.

TimeoutException

Der Vorgang konnte innerhalb des Standardtimeouts nicht abgeschlossen werden.

FabricNotPrimaryException

Die Ausnahme, die ausgelöst wird, wenn der nicht in ist.

TransactionFaultedException

Die Transaktion wurde intern vom System fehlerhaft gemacht. Wiederholen des Vorgangs für eine neue Transaktion

InvalidOperationException

Wird ausgelöst, wenn ein Methodenaufruf für den aktuellen Zustand des Objekts ungültig ist. Beispiel: Die verwendete Transaktion ist bereits beendet: vom Benutzer zugesagt oder abgebrochen. Wenn diese Ausnahme ausgelöst wird, ist es sehr wahrscheinlich, dass im Dienstcode der Verwendung von Transaktionen ein Fehler vorliegt.

Hinweise

Wenn von dieser Methode eine retriable Ausnahme ausgelöst wird, wird empfohlen, die Transaktion tx zu verwerfen und mit einer neuen Transaktion erneut zu versuchen.

TryDequeueAsync(ITransaction, TimeSpan, CancellationToken)

Versucht, das Objekt am Anfang der zuverlässigen Warteschlange zu entfernen und zurückzugeben.

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

Parameter

tx

ITransaction

Transaktion, der dieser Vorgang zugeordnet werden soll.

timeout

TimeSpan

Die Zeit, die gewartet werden muss, bis der Vorgang abgeschlossen ist, bevor eine TimeoutException ausgelöst wird. Wird in erster Linie verwendet, um Deadlocks zu verhindern. Der Standardwert ist 4 Sekunden.

cancellationToken

CancellationToken

Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist „None“.

Gibt zurück

Task<ConditionalValue<T>>

Aufgabe, die den asynchronen Vorgang des Ausqueues darstellt. Das Aufgabenergebnis ist ein Tupel, das angibt, ob ein Objekt entfernt wurde, und wenn ja, das Objekt.

Ausnahmen

ArgumentNullException

tx ist NULL.

ArgumentException

timeout ist ein negativer Wert.

TimeoutException

Der Vorgang konnte innerhalb des angegebenen Timeouts nicht abgeschlossen werden.

OperationCanceledException

Der Vorgang wurde abgebrochen.

FabricNotPrimaryException

Die Ausnahme, die ausgelöst wird, wenn der nicht in ist.

TransactionFaultedException

Die Transaktion wurde intern vom System fehlerhaft gemacht. Wiederholen des Vorgangs für eine neue Transaktion

InvalidOperationException

Wird ausgelöst, wenn ein Methodenaufruf für den aktuellen Zustand des Objekts ungültig ist. Beispiel: Die verwendete Transaktion ist bereits beendet: vom Benutzer zugesagt oder abgebrochen. Wenn diese Ausnahme ausgelöst wird, ist es sehr wahrscheinlich, dass im Dienstcode der Verwendung von Transaktionen ein Fehler vorliegt.

Hinweise

Wenn von dieser Methode eine retriable Ausnahme ausgelöst wird, wird empfohlen, die Transaktion tx zu verwerfen und mit einer neuen Transaktion erneut zu versuchen.