IReliableDictionary<TKey,TValue>.TryAddAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
TryAddAsync(ITransaction, TKey, TValue) |
指定したキーと値を Reliable Dictionary に追加しようとします。 |
TryAddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken) |
指定したキーと値を Reliable Dictionary に追加しようとします。 |
TryAddAsync(ITransaction, TKey, TValue)
指定したキーと値を Reliable Dictionary に追加しようとします。
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)
パラメーター
- tx
- ITransaction
この操作を関連付けるトランザクション。
- key
- TKey
追加する要素のキー。
- value
- TValue
追加する要素の値。 参照型の場合は、値を null にできます。
戻り値
非同期の追加操作を表すタスク。 タスクの結果は、キーと値のペアが追加されたかどうかを示します。
例外
tx
が null であるか、null key
であるか、シリアル化できません。
既定のタイムアウト内で操作を完了できませんでした。
が にないPrimary場合にIReliableDictionary<TKey,TValue>スローされる例外。
トランザクションがシステムによって内部的に障害が発生しました。 新しいトランザクションで操作を再試行する
オブジェクトの現在の状態に対してメソッド呼び出しが無効な場合にスローされます。 たとえば、使用されているトランザクションは既に終了しています。ユーザーによってコミットまたは中止されています。 この例外がスローされた場合、トランザクションを使用するサービス コードにバグがある可能性が高くなります。
Reliable Dictionary が閉じられたり削除されたりすることを示します。
適用対象
TryAddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)
指定したキーと値を Reliable Dictionary に追加しようとします。
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)
パラメーター
- tx
- ITransaction
この操作を関連付けるトランザクション。
- key
- TKey
追加する要素のキー。
- value
- TValue
追加する要素の値。 参照型の場合は、値を null にできます。
- timeout
- TimeSpan
TimeoutException をスローするまでの操作の完了を待機する時間。 主にデッドロックを防ぐために使用されます。 既定値は 4 秒です。
- cancellationToken
- CancellationToken
キャンセル要求を監視するためのトークン。 既定値は None です。
戻り値
非同期の追加操作を表すタスク。 タスクの結果は、キーと値のペアが追加されたかどうかを示します。
例外
tx
が null であるか、null key
であるか、シリアル化できません。
timeout
が負の値です。
指定されたタイムアウト内に操作を完了できませんでした。
操作は取り消されました。
が にないPrimary場合にIReliableDictionary<TKey,TValue>スローされる例外。
トランザクションがシステムによって内部的に障害が発生しました。 新しいトランザクションで操作を再試行する
オブジェクトの現在の状態に対してメソッド呼び出しが無効な場合にスローされます。 たとえば、使用されているトランザクションは既に終了しています。ユーザーによってコミットまたは中止されています。 この例外がスローされた場合、トランザクションを使用するサービス コードにバグがある可能性が高くなります。
Reliable Dictionary が閉じられたり削除されたりすることを示します。
適用対象
Azure SDK for .NET