IReliableDictionary<TKey,TValue>.GetOrAddAsync 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
GetOrAddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken) |
Fügt dem Zuverlässigen Wörterbuch ein Schlüssel-Wert-Paar hinzu, wenn der Schlüssel noch nicht vorhanden ist. |
GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>, TimeSpan, CancellationToken) |
Fügt dem Zuverlässigen Wörterbuch mithilfe der angegebenen Funktion ein Schlüssel-Wert-Paar hinzu, wenn der Schlüssel noch nicht vorhanden ist. |
GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>) |
Fügt dem Zuverlässigen Wörterbuch mithilfe der angegebenen Funktion ein Schlüssel-Wert-Paar hinzu, wenn der Schlüssel noch nicht vorhanden ist. |
GetOrAddAsync(ITransaction, TKey, TValue) |
Fügt dem Zuverlässigen Wörterbuch ein Schlüssel-Wert-Paar hinzu, wenn der Schlüssel noch nicht vorhanden ist. Wenn der Schlüssel vorhanden ist, werden keine Aktualisierungen des Werts vorgenommen. |
GetOrAddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)
Fügt dem Zuverlässigen Wörterbuch ein Schlüssel-Wert-Paar hinzu, wenn der Schlüssel noch nicht vorhanden ist.
public System.Threading.Tasks.Task<TValue> GetOrAddAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue value, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Value>
Public Function GetOrAddAsync (tx As ITransaction, key As TKey, value As TValue, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of TValue)
Parameter
- tx
- ITransaction
Transaktion, der dieser Vorgang zugeordnet werden soll.
- key
- TKey
Der Schlüssel des hinzuzufügenden Elements.
- value
- TValue
Der hinzuzufügende Wert, wenn der Schlüssel nicht bereits vorhanden ist.
- 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 Add-Vorgang darstellt. Das Vorgangsergebnis ist der Wert für den Schlüssel. Dies ist entweder der vorhandene Wert für den Schlüssel, wenn sich der Schlüssel bereits im zuverlässigen Wörterbuch befindet, oder der neue Wert, wenn sich der Schlüssel nicht im zuverlässigen Wörterbuch befand.
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:
GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>, TimeSpan, CancellationToken)
Fügt dem Zuverlässigen Wörterbuch mithilfe der angegebenen Funktion ein Schlüssel-Wert-Paar hinzu, wenn der Schlüssel noch nicht vorhanden ist.
public System.Threading.Tasks.Task<TValue> GetOrAddAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Func<TKey,TValue> valueFactory, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Func<'Key, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)> * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Value>
Public Function GetOrAddAsync (tx As ITransaction, key As TKey, valueFactory As Func(Of TKey, TValue), timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of TValue)
Parameter
- tx
- ITransaction
Transaktion, der dieser Vorgang zugeordnet werden soll.
- key
- TKey
Der Schlüssel des hinzuzufügenden Elements.
- valueFactory
- Func<TKey,TValue>
Die Funktion, mit der ein Wert für den Schlüssel generiert wird.
- 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 Add-Vorgang darstellt. Das Vorgangsergebnis ist der Wert für den Schlüssel. Dies ist entweder der vorhandene Wert für den Schlüssel, wenn sich der Schlüssel bereits im Zuverlässigen Wörterbuch befindet, oder der neue Wert für den Schlüssel, der von valueFactory zurückgegeben wird, wenn der Schlüssel nicht im zuverlässigen Wörterbuch enthalten ist.
Ausnahmen
tx
ist NULL, ist NULL, key
ist NULL oder kann nicht serialisiert werden oder valueFactory
ist NULL.
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:
GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>)
Fügt dem Zuverlässigen Wörterbuch mithilfe der angegebenen Funktion ein Schlüssel-Wert-Paar hinzu, wenn der Schlüssel noch nicht vorhanden ist.
public System.Threading.Tasks.Task<TValue> GetOrAddAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Func<TKey,TValue> valueFactory);
abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Func<'Key, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)> -> System.Threading.Tasks.Task<'Value>
Public Function GetOrAddAsync (tx As ITransaction, key As TKey, valueFactory As Func(Of TKey, TValue)) As Task(Of TValue)
Parameter
- tx
- ITransaction
Transaktion, der dieser Vorgang zugeordnet werden soll.
- key
- TKey
Der Schlüssel des hinzuzufügenden Elements.
- valueFactory
- Func<TKey,TValue>
Die Funktion, mit der ein Wert für den Schlüssel generiert wird.
Gibt zurück
Eine Aufgabe, die den asynchronen Add-Vorgang darstellt. Das Vorgangsergebnis ist der Wert für den Schlüssel. Dies ist entweder der vorhandene Wert für den Schlüssel, wenn sich der Schlüssel bereits im Zuverlässigen Wörterbuch befindet, oder der neue Wert für den Schlüssel, der von valueFactory zurückgegeben wird, wenn der Schlüssel nicht im zuverlässigen Wörterbuch enthalten ist.
Ausnahmen
tx
ist NULL, ist NULL, key
ist NULL oder kann nicht serialisiert werden oder valueFactory
ist NULL.
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:
GetOrAddAsync(ITransaction, TKey, TValue)
Fügt dem Zuverlässigen Wörterbuch ein Schlüssel-Wert-Paar hinzu, wenn der Schlüssel noch nicht vorhanden ist. Wenn der Schlüssel vorhanden ist, werden keine Aktualisierungen des Werts vorgenommen.
public System.Threading.Tasks.Task<TValue> GetOrAddAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue value);
abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value -> System.Threading.Tasks.Task<'Value>
Public Function GetOrAddAsync (tx As ITransaction, key As TKey, value As TValue) As Task(Of TValue)
Parameter
- tx
- ITransaction
Transaktion, der dieser Vorgang zugeordnet werden soll.
- key
- TKey
Der Schlüssel des hinzuzufügenden Elements.
- value
- TValue
Der hinzuzufügende Wert, wenn der Schlüssel nicht bereits vorhanden ist.
Gibt zurück
Eine Aufgabe, die den asynchronen Add-Vorgang darstellt. Das Vorgangsergebnis ist der Wert für den Schlüssel. Dies ist entweder der vorhandene Wert für den Schlüssel, wenn sich der Schlüssel bereits im zuverlässigen Wörterbuch befindet, oder der neue Wert, wenn sich der Schlüssel nicht im zuverlässigen Wörterbuch befand.
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:
Azure SDK for .NET
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für