IReliableDictionary<TKey,TValue>.TryAddAsync Methode

Definition

Überlädt

TryAddAsync(ITransaction, TKey, TValue)

Versucht, dem Reliable Dictionary den angegebenen Schlüssel und Wert hinzuzufügen.

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

Versucht, dem Reliable Dictionary den angegebenen Schlüssel und Wert hinzuzufügen.

TryAddAsync(ITransaction, TKey, TValue)

Versucht, dem Reliable Dictionary den angegebenen Schlüssel und Wert hinzuzufügen.

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)

Parameter

tx
ITransaction

Transaktion, der dieser Vorgang zugeordnet werden soll.

key
TKey

Der Schlüssel des hinzuzufügenden Elements.

value
TValue

Der Wert des hinzuzufügenden Elements. Der Wert kann für Verweistypen NULL sein.

Gibt zurück

Eine Aufgabe, die den asynchronen Add-Vorgang darstellt. Das Vorgangsergebnis gibt an, ob das Schlüssel-Wert-Paar hinzugefügt wurde.

Ausnahmen

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

Der Vorgang konnte nicht innerhalb des Standardtimeouts abgeschlossen werden.

Die Ausnahme, die ausgelöst wird, wenn sich nicht IReliableDictionary<TKey,TValue> in befindet Primary.

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

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

Gilt für:

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

Versucht, dem Reliable Dictionary den angegebenen Schlüssel und Wert hinzuzufügen.

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)

Parameter

tx
ITransaction

Transaktion, der dieser Vorgang zugeordnet werden soll.

key
TKey

Der Schlüssel des hinzuzufügenden Elements.

value
TValue

Der Wert des hinzuzufügenden Elements. Der Wert kann für Verweistypen NULL sein.

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

Eine Aufgabe, die den asynchronen Add-Vorgang darstellt. Das Vorgangsergebnis gibt an, ob das Schlüssel-Wert-Paar hinzugefügt wurde.

Ausnahmen

tx ist NULL oder key ist 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 sich nicht IReliableDictionary<TKey,TValue> in befindet Primary.

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

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

Gilt für: