IReliableDictionary<TKey,TValue>.TryAddAsync Methode
Definition
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
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:
Azure SDK for .NET