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

定義

名前空間:

Microsoft.ServiceFabric.Data.Collections

アセンブリ:

Microsoft.ServiceFabric.Data.Interfaces.dll

パッケージ:

Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

オーバーロード

SetAsync(ITransaction, TKey, TValue)	キーがまだ存在しない場合は、キーと値のペアを Reliable Dictionary に追加するか、キーが既に存在する場合は Reliable Dictionary 内のキーと値のペアを更新します。
SetAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)	キーがまだ存在しない場合は、キーと値のペアを Reliable Dictionary に追加するか、キーが既に存在する場合は Reliable Dictionary 内のキーと値のペアを更新します。

SetAsync(ITransaction, TKey, TValue)

キーがまだ存在しない場合は、キーと値のペアを Reliable Dictionary に追加するか、キーが既に存在する場合は Reliable Dictionary 内のキーと値のペアを更新します。

public System.Threading.Tasks.Task SetAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue value);

abstract member SetAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value -> System.Threading.Tasks.Task

Public Function SetAsync (tx As ITransaction, key As TKey, value As TValue) As Task

パラメーター

tx

ITransaction

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

key

TKey

値を更新する必要があるキー。

value

TValue

指定した keyを持つ要素の値を置き換える値。

戻り値

Task

非同期更新操作を表すタスク。

例外

ArgumentNullException

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

TimeoutException

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

FabricNotPrimaryException

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

TransactionFaultedException

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

InvalidOperationException

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

FabricObjectClosedException

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

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

キーがまだ存在しない場合は、キーと値のペアを Reliable Dictionary に追加するか、キーが既に存在する場合は Reliable Dictionary 内のキーと値のペアを更新します。

public System.Threading.Tasks.Task SetAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue value, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

abstract member SetAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SetAsync (tx As ITransaction, key As TKey, value As TValue, timeout As TimeSpan, cancellationToken As CancellationToken) As Task

パラメーター

tx

ITransaction

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

key

TKey

値を更新する必要があるキー。

value

TValue

指定した keyを持つ要素の値を置き換える値。

timeout

TimeSpan

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

cancellationToken

CancellationToken

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

戻り値

Task

非同期更新操作を表すタスク。

例外

ArgumentNullException

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

ArgumentException

timeout が負の値です。

TimeoutException

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

OperationCanceledException

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

FabricNotPrimaryException

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

TransactionFaultedException

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

InvalidOperationException

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

FabricObjectClosedException

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