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

リファレンス

定義

名前空間:: Microsoft.ServiceFabric.Data.Collections

アセンブリ:: Microsoft.ServiceFabric.Data.Interfaces.dll

パッケージ:: Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

TryGetValueAsync(ITransaction, TKey)	Reliable Dictionary から、指定したキーに関連付けられている値の取得を試みます。
TryGetValueAsync(ITransaction, TKey, LockMode)	Reliable Dictionary から、指定したキーに関連付けられている値の取得を試みます。
TryGetValueAsync(ITransaction, TKey, TimeSpan, CancellationToken)	Reliable Dictionary から、指定したキーに関連付けられている値の取得を試みます。
TryGetValueAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken)	Reliable Dictionary から、指定したキーに関連付けられている値の取得を試みます。

TryGetValueAsync(ITransaction, TKey)

Reliable Dictionary から、指定したキーに関連付けられている値の取得を試みます。

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<TValue>> TryGetValueAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key);

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

Public Function TryGetValueAsync (tx As ITransaction, key As TKey) As Task(Of ConditionalValue(Of TValue))

パラメーター

tx: ITransaction

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

key: TKey

取得する値のキー。

戻り値

Task<ConditionalValue<TValue>>

非同期の読み取り操作を表すタスク。タスクの結果は、キーが Reliable Dictionary で見つかったかどうか、その場合は値を示すタプルです。

例外

ArgumentNullException

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

TimeoutException

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

FabricNotReadableException

現在、IReliableDictionary が読み取りを提供できないことを示します。この例外は、すべて ReplicaRoleでスローできます。ロールでスローされる理由の 1 つは、 Primary の ReadStatus損失です。ロールでスローされる理由の ActiveSecondary 1 つは、Reliable Collection の状態がまだ一貫性がないということです。

TransactionFaultedException

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

InvalidOperationException

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

FabricObjectClosedException

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

適用対象

TryGetValueAsync(ITransaction, TKey, LockMode)

Reliable Dictionary から、指定したキーに関連付けられている値の取得を試みます。

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<TValue>> TryGetValueAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Microsoft.ServiceFabric.Data.Collections.LockMode lockMode);

abstract member TryGetValueAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Microsoft.ServiceFabric.Data.Collections.LockMode -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<'Value>>

Public Function TryGetValueAsync (tx As ITransaction, key As TKey, lockMode As LockMode) As Task(Of ConditionalValue(Of TValue))

パラメーター

tx: ITransaction

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

key: TKey

取得する値のキー。

lockMode: LockMode

この読み取り操作に使用するロックの種類。

戻り値

Task<ConditionalValue<TValue>>

非同期の読み取り操作を表すタスク。タスクの結果は、キーが Reliable Dictionary で見つかったかどうか、その場合は値を示すタプルです。

例外

ArgumentNullException

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

TimeoutException

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

FabricNotReadableException

TransactionFaultedException

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

InvalidOperationException

FabricObjectClosedException

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

適用対象

TryGetValueAsync(ITransaction, TKey, TimeSpan, CancellationToken)

Reliable Dictionary から、指定したキーに関連付けられている値の取得を試みます。

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<TValue>> TryGetValueAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

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

Public Function TryGetValueAsync (tx As ITransaction, key As TKey, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ConditionalValue(Of TValue))

パラメーター

tx: ITransaction

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

key: TKey

取得する値のキー。

timeout: TimeSpan

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

cancellationToken: CancellationToken

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

戻り値

Task<ConditionalValue<TValue>>

非同期の読み取り操作を表すタスク。タスクの結果は、キーが Reliable Dictionary で見つかったかどうか、その場合は値を示すタプルです。

例外

ArgumentNullException

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

ArgumentException

timeout が負の値です。

TimeoutException

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

OperationCanceledException

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

FabricNotReadableException

TransactionFaultedException

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

InvalidOperationException

FabricObjectClosedException

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

適用対象

TryGetValueAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken)

Reliable Dictionary から、指定したキーに関連付けられている値の取得を試みます。

public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<TValue>> TryGetValueAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Microsoft.ServiceFabric.Data.Collections.LockMode lockMode, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

abstract member TryGetValueAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Microsoft.ServiceFabric.Data.Collections.LockMode * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<'Value>>

Public Function TryGetValueAsync (tx As ITransaction, key As TKey, lockMode As LockMode, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ConditionalValue(Of TValue))