IReliableDictionary<TKey,TValue>.TryUpdateAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
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 が閉じているか削除されていることを示します。
適用対象
Azure SDK for .NET