IReliableDictionary<TKey,TValue>.TryUpdateAsync Methode

Definition

Überlädt

TryUpdateAsync(ITransaction, TKey, TValue, TValue)

Vergleicht den vorhandenen Wert für den angegebenen Schlüssel mit einem angegebenen Wert und aktualisiert den Schlüssel mit einem dritten Wert, wenn sie gleich sind.

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

Vergleicht den vorhandenen Wert für den angegebenen Schlüssel mit einem angegebenen Wert und aktualisiert den Schlüssel mit einem dritten Wert, wenn sie gleich sind.

TryUpdateAsync(ITransaction, TKey, TValue, TValue)

Vergleicht den vorhandenen Wert für den angegebenen Schlüssel mit einem angegebenen Wert und aktualisiert den Schlüssel mit einem dritten Wert, wenn sie gleich sind.

public System.Threading.Tasks.Task<bool> TryUpdateAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue newValue, TValue comparisonValue);
abstract member TryUpdateAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * 'Value -> System.Threading.Tasks.Task<bool>
Public Function TryUpdateAsync (tx As ITransaction, key As TKey, newValue As TValue, comparisonValue As TValue) As Task(Of Boolean)

Parameter

tx
ITransaction

Transaktion, der dieser Vorgang zugeordnet werden soll.

key
TKey

Der Schlüssel, dessen Wert mit comparisonValue verglichen und möglicherweise ersetzt wird.

newValue
TValue

Der Wert, der den Wert des Elements mit dem angegebenen key ersetzt, wenn der Vergleich Gleichheit ergibt.

comparisonValue
TValue

Der Wert, der mit dem Wert des -Elements verglichen wird, das über den angegebenen keyverfügt.

Gibt zurück

Eine Aufgabe, die den asynchronen Aktualisierungsvorgang darstellt. Das Aufgabenergebnis gibt an, ob das Objekt aktualisiert wurde.

Ausnahmen

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

Der Vorgang konnte innerhalb des Standardtimeouts nicht abgeschlossen werden.

Die Ausnahme, die ausgelöst wird, wenn der IReliableDictionary<TKey,TValue> nicht in Primaryist.

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

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.

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

Gilt für:

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

Vergleicht den vorhandenen Wert für den angegebenen Schlüssel mit einem angegebenen Wert und aktualisiert den Schlüssel mit einem dritten Wert, wenn sie gleich sind.

public System.Threading.Tasks.Task<bool> TryUpdateAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue newValue, TValue comparisonValue, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
abstract member TryUpdateAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * 'Value * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Function TryUpdateAsync (tx As ITransaction, key As TKey, newValue As TValue, comparisonValue As TValue, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of Boolean)

Parameter

tx
ITransaction

Transaktion, der dieser Vorgang zugeordnet werden soll.

key
TKey

Der Schlüssel, dessen Wert mit comparisonValue verglichen und möglicherweise ersetzt wird.

newValue
TValue

Der Wert, der den Wert des Elements mit dem angegebenen key ersetzt, wenn der Vergleich Gleichheit ergibt.

comparisonValue
TValue

Der Wert, der mit dem Wert des -Elements verglichen wird, das über den angegebenen keyverfügt.

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

Eine Aufgabe, die den asynchronen Aktualisierungsvorgang darstellt. Das Aufgabenergebnis gibt an, ob das Objekt aktualisiert wurde.

Ausnahmen

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

timeout ist ein negativer Wert.

Der Vorgang konnte innerhalb des angegebenen Timeouts nicht abgeschlossen werden.

Der Vorgang wurde abgebrochen.

Die Ausnahme, die ausgelöst wird, wenn der IReliableDictionary<TKey,TValue> nicht in Primaryist.

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

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.

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

Gilt für: