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

定義

オーバーロード

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 が閉じられたり削除されたりすることを示します。

適用対象