IReliableDictionary<TKey,TValue>.TryGetValueAsync Methode

Referenz

Definition

Namespace:: Microsoft.ServiceFabric.Data.Collections

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

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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

TryGetValueAsync(ITransaction, TKey)	Versucht, den dem angegebenen Schlüssel zugeordneten Wert aus dem Reliable Dictionary abzurufen.
TryGetValueAsync(ITransaction, TKey, LockMode)	Versucht, den dem angegebenen Schlüssel zugeordneten Wert aus dem Reliable Dictionary abzurufen.
TryGetValueAsync(ITransaction, TKey, TimeSpan, CancellationToken)	Versucht, den dem angegebenen Schlüssel zugeordneten Wert aus dem Reliable Dictionary abzurufen.
TryGetValueAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken)	Versucht, den dem angegebenen Schlüssel zugeordneten Wert aus dem Reliable Dictionary abzurufen.

TryGetValueAsync(ITransaction, TKey)

Versucht, den dem angegebenen Schlüssel zugeordneten Wert aus dem Reliable Dictionary abzurufen.

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

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

Public Function TryGetValueAsync (tx As ITransaction, key As TKey) As Task(Of ConditionalValue(Of TValue))

Parameter

tx: ITransaction

Transaktion, der dieser Vorgang zugeordnet werden soll.

key: TKey

Der Schlüssel des abzurufenden Werts.

Gibt zurück

Task<ConditionalValue<TValue>>

Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Das Ergebnis der Aufgabe ist ein Tupel, das angibt, ob der Schlüssel im Reliable Dictionary gefunden wurde, und wenn ja, den Wert.

Ausnahmen

ArgumentNullException

tx ist NULL oder key ist NULL oder kann nicht serialisiert werden.

TimeoutException

Der Vorgang konnte nicht innerhalb des Standardtimeouts abgeschlossen werden.

FabricNotReadableException

Gibt an, dass das IReliableDictionary derzeit keine Lesevorgänge verarbeiten kann. Diese Ausnahme kann in allen ReplicaRoles ausgelöst werden. Ein Grund, warum es in der Rolle ausgelöst werden kann, ist der Primary Verlust von ReadStatus. Ein Grund, warum es in der ActiveSecondary Rolle ausgelöst wird, ist, dass der Status von Reliable Collection noch nicht konsistent 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 wurde bereits beendet: Vom Benutzer committet oder abgebrochen. Wenn diese Ausnahme ausgelöst wird, ist es sehr wahrscheinlich, dass im Dienstcode der Verwendung von Transaktionen ein Fehler vorliegt.

FabricObjectClosedException

Gibt an, dass das Reliable Dictionary geschlossen oder gelöscht wird.

Gilt für:

TryGetValueAsync(ITransaction, TKey, LockMode)

Versucht, den dem angegebenen Schlüssel zugeordneten Wert aus dem Reliable Dictionary abzurufen.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<TValue>> TryGetValueAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Microsoft.ServiceFabric.Data.Collections.LockMode lockMode);

abstract member TryGetValueAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Microsoft.ServiceFabric.Data.Collections.LockMode -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<'Value>>

Public Function TryGetValueAsync (tx As ITransaction, key As TKey, lockMode As LockMode) As Task(Of ConditionalValue(Of TValue))

Parameter

tx: ITransaction

Transaktion, der dieser Vorgang zugeordnet werden soll.

key: TKey

Der Schlüssel des abzurufenden Werts.

lockMode: LockMode

Art der Sperre, die für diesen Lesevorgang verwendet werden soll.

Gibt zurück

Task<ConditionalValue<TValue>>

Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Das Ergebnis der Aufgabe ist ein Tupel, das angibt, ob der Schlüssel im Reliable Dictionary gefunden wurde, und wenn ja, den Wert.

Ausnahmen

ArgumentNullException

tx ist NULL oder key ist NULL oder kann nicht serialisiert werden.

TimeoutException

Der Vorgang konnte nicht innerhalb des Standardtimeouts abgeschlossen werden.

FabricNotReadableException

TransactionFaultedException

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

InvalidOperationException

FabricObjectClosedException

Gibt an, dass das Reliable Dictionary geschlossen oder gelöscht wird.

Gilt für:

TryGetValueAsync(ITransaction, TKey, TimeSpan, CancellationToken)

Versucht, den dem angegebenen Schlüssel zugeordneten Wert aus dem Reliable Dictionary abzurufen.

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

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

Public Function TryGetValueAsync (tx As ITransaction, key As TKey, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ConditionalValue(Of TValue))

Parameter

tx: ITransaction

Transaktion, der dieser Vorgang zugeordnet werden soll.

key: TKey

Der Schlüssel des abzurufenden Werts.

timeout: TimeSpan

Die Zeitspanne, die auf den Abschluss des Vorgangs gewartet werden muss, bevor eine TimeoutException ausgelöst wird. Wird hauptsächlich 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<TValue>>

Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Das Ergebnis der Aufgabe ist ein Tupel, das angibt, ob der Schlüssel im Reliable Dictionary gefunden wurde, und wenn ja, den Wert.

Ausnahmen

ArgumentNullException

tx ist NULL oder key ist NULL oder kann nicht serialisiert werden.

ArgumentException

timeout ist ein negativer Wert.

TimeoutException

Der Vorgang konnte innerhalb des angegebenen Timeouts nicht abgeschlossen werden.

OperationCanceledException

Der Vorgang wurde abgebrochen.

FabricNotReadableException

TransactionFaultedException

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

InvalidOperationException

FabricObjectClosedException

Gibt an, dass das Reliable Dictionary geschlossen oder gelöscht wird.

Gilt für:

TryGetValueAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken)

Versucht, den dem angegebenen Schlüssel zugeordneten Wert aus dem Reliable Dictionary abzurufen.

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<TValue>> TryGetValueAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Microsoft.ServiceFabric.Data.Collections.LockMode lockMode, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

abstract member TryGetValueAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Microsoft.ServiceFabric.Data.Collections.LockMode * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<'Value>>

Public Function TryGetValueAsync (tx As ITransaction, key As TKey, lockMode As LockMode, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ConditionalValue(Of TValue))

Parameter

tx: ITransaction

Transaktion, der dieser Vorgang zugeordnet werden soll.

key: TKey

Der Schlüssel des abzurufenden Werts.

lockMode: LockMode

Art der Sperre, die für diesen Lesevorgang verwendet werden soll.

timeout: TimeSpan

cancellationToken: CancellationToken

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

Gibt zurück

Task<ConditionalValue<TValue>>

Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Das Ergebnis der Aufgabe ist ein Tupel, das angibt, ob der Schlüssel im Reliable Dictionary gefunden wurde, und wenn ja, den Wert.