IReliableDictionary<TKey,TValue>.TryUpdateAsync メソッド

定義

オーバーロード

TryUpdateAsync(ITransaction, TKey, TValue, TValue)

指定したキーの既存の値と指定した値を比較し、等しい場合は別の値でキーを更新します。

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

指定したキーの既存の値と指定した値を比較し、等しい場合は別の値でキーを更新します。

TryUpdateAsync(ITransaction, TKey, TValue, TValue)

指定したキーの既存の値と指定した値を比較し、等しい場合は別の値でキーを更新します。

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)

パラメーター

tx
ITransaction

この操作を関連付けるトランザクション。

key
TKey

値が と comparisonValue 比較され、置き換えられる可能性があるキー。

newValue
TValue

比較した結果が等しい場合に、指定した key を持つ要素の値を置き換える値。

comparisonValue
TValue

指定 keyした を持つ要素の値と比較される値。

戻り値

非同期更新操作を表すタスク。 タスクの結果は、オブジェクトが更新されたかどうかを示します。

例外

tx が null であるか、null key であるか、シリアル化できません。

既定のタイムアウト内に操作を完了できませんでした。

が 内Primaryにない場合にIReliableDictionary<TKey,TValue>スローされる例外。

トランザクションは、システムによって内部的に障害が発生しました。 新しいトランザクションで操作を再試行する

オブジェクトの現在の状態に対してメソッド呼び出しが無効な場合にスローされます。 たとえば、使用されているトランザクションは既に終了しています。コミットまたは中止されます。 この例外がスローされた場合、トランザクションの使用に関するサービス コードにバグがある可能性が高くなります。

Reliable Dictionary が閉じているか削除されていることを示します。

適用対象

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

指定したキーの既存の値と指定した値を比較し、等しい場合は別の値でキーを更新します。

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)

パラメーター

tx
ITransaction

この操作を関連付けるトランザクション。

key
TKey

値が と comparisonValue 比較され、置き換えられる可能性があるキー。

newValue
TValue

比較した結果が等しい場合に、指定した key を持つ要素の値を置き換える値。

comparisonValue
TValue

指定 keyした を持つ要素の値と比較される値。

timeout
TimeSpan

TimeoutException をスローするまでの操作の完了を待機する時間。 主にデッドロックを防ぐために使用されます。 既定値は 4 秒です。

cancellationToken
CancellationToken

キャンセル要求を監視するためのトークン。 既定値は None です。

戻り値

非同期更新操作を表すタスク。 タスクの結果は、オブジェクトが更新されたかどうかを示します。

例外

tx が null であるか、null key であるか、シリアル化できません。

timeout が負の値です。

指定されたタイムアウト内に操作を完了できませんでした。

操作は取り消されました。

が 内Primaryにない場合にIReliableDictionary<TKey,TValue>スローされる例外。

トランザクションは、システムによって内部的に障害が発生しました。 新しいトランザクションで操作を再試行する

オブジェクトの現在の状態に対してメソッド呼び出しが無効な場合にスローされます。 たとえば、使用されているトランザクションは既に終了しています。コミットまたは中止されます。 この例外がスローされた場合、トランザクションの使用に関するサービス コードにバグがある可能性が高くなります。

Reliable Dictionary が閉じているか削除されていることを示します。

適用対象