IReliableDictionary3<TKey,TValue>.TryGetVersionedKeyValuePairAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| TryGetVersionedKeyValuePairAsync(ITransaction, TKey) |
(ベータ)Reliable Dictionary から、指定したキーに関連付けられているバージョン管理された要素の取得を試みます。 |
| TryGetVersionedKeyValuePairAsync(ITransaction, TKey, LockMode) |
(ベータ)Reliable Dictionary から、指定したキーに関連付けられているバージョン管理された要素の取得を試みます。 |
| TryGetVersionedKeyValuePairAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken) |
(ベータ)Reliable Dictionary から、指定したキーに関連付けられているバージョン管理された要素の取得を試みます。 |
TryGetVersionedKeyValuePairAsync(ITransaction, TKey)
(ベータ)Reliable Dictionary から、指定したキーに関連付けられているバージョン管理された要素の取得を試みます。
public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<TKey,TValue>>> TryGetVersionedKeyValuePairAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key);abstract member TryGetVersionedKeyValuePairAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<'Key, 'Value>>>Public Function TryGetVersionedKeyValuePairAsync (tx As ITransaction, key As TKey) As Task(Of ConditionalValue(Of VersionedKeyValuePair(Of TKey, TValue)))パラメーター
- tx
- ITransaction
この操作を関連付けるトランザクション。
- key
- TKey
取得するバージョン管理された要素のキー。
戻り値
非同期の読み取り操作を表すタスク。 タスクの結果は、キーが Reliable Dictionary で見つかったかどうか、および見つかった場合は値とシーケンス番号を示すタプルです。
例外
tx が null であるか、null key であるか、シリアル化できません。
指定されたタイムアウト内に操作を完了できませんでした。
操作は取り消されました。
現在、IReliableDictionary が読み取りを提供できないことを示します。 この例外は、すべて ReplicaRoleでスローできます。 ロールでスローされる理由の 1 つは、 Primary の ReadStatus損失です。 ロールでスローされる理由の ActiveSecondary 1 つは、Reliable Collection の状態がまだ一貫性がないということです。
トランザクションがシステムによって内部的に障害が発生しました。 新しいトランザクションで操作を再試行する
オブジェクトの現在の状態に対してメソッド呼び出しが無効な場合にスローされます。 たとえば、使用されているトランザクションは既に終了しています。ユーザーによってコミットまたは中止されています。 この例外がスローされた場合、トランザクションを使用するサービス コードにバグがある可能性が高くなります。
Reliable Dictionary が閉じられたり削除されたりすることを示します。
適用対象
TryGetVersionedKeyValuePairAsync(ITransaction, TKey, LockMode)
(ベータ)Reliable Dictionary から、指定したキーに関連付けられているバージョン管理された要素の取得を試みます。
public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<TKey,TValue>>> TryGetVersionedKeyValuePairAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Microsoft.ServiceFabric.Data.Collections.LockMode lockMode);abstract member TryGetVersionedKeyValuePairAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Microsoft.ServiceFabric.Data.Collections.LockMode -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<'Key, 'Value>>>Public Function TryGetVersionedKeyValuePairAsync (tx As ITransaction, key As TKey, lockMode As LockMode) As Task(Of ConditionalValue(Of VersionedKeyValuePair(Of TKey, TValue)))パラメーター
- tx
- ITransaction
この操作を関連付けるトランザクション。
- key
- TKey
取得するバージョン管理された要素のキー。
- lockMode
- LockMode
この読み取り操作に使用するロックの種類。
戻り値
非同期の読み取り操作を表すタスク。 タスクの結果は、キーが Reliable Dictionary で見つかったかどうか、および見つかった場合は値とシーケンス番号を示すタプルです。
例外
tx が null であるか、null key であるか、シリアル化できません。
指定されたタイムアウト内に操作を完了できませんでした。
操作は取り消されました。
現在、IReliableDictionary が読み取りを提供できないことを示します。 この例外は、すべて ReplicaRoleでスローできます。 ロールでスローされる理由の 1 つは、 Primary の ReadStatus損失です。 ロールでスローされる理由の ActiveSecondary 1 つは、Reliable Collection の状態がまだ一貫性がないということです。
トランザクションがシステムによって内部的に障害が発生しました。 新しいトランザクションで操作を再試行する
オブジェクトの現在の状態に対してメソッド呼び出しが無効な場合にスローされます。 たとえば、使用されているトランザクションは既に終了しています。ユーザーによってコミットまたは中止されています。 この例外がスローされた場合、トランザクションを使用するサービス コードにバグがある可能性が高くなります。
Reliable Dictionary が閉じられたり削除されたりすることを示します。
適用対象
TryGetVersionedKeyValuePairAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken)
(ベータ)Reliable Dictionary から、指定したキーに関連付けられているバージョン管理された要素の取得を試みます。
public System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<TKey,TValue>>> TryGetVersionedKeyValuePairAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Microsoft.ServiceFabric.Data.Collections.LockMode lockMode, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);abstract member TryGetVersionedKeyValuePairAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Microsoft.ServiceFabric.Data.Collections.LockMode * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.ServiceFabric.Data.ConditionalValue<Microsoft.ServiceFabric.Data.VersionedKeyValuePair<'Key, 'Value>>>Public Function TryGetVersionedKeyValuePairAsync (tx As ITransaction, key As TKey, lockMode As LockMode, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of ConditionalValue(Of VersionedKeyValuePair(Of TKey, TValue)))パラメーター
- tx
- ITransaction
この操作を関連付けるトランザクション。
- key
- TKey
取得するバージョン管理された要素のキー。
- lockMode
- LockMode
この読み取り操作に使用するロックの種類。
- timeout
- TimeSpan
TimeoutException をスローするまでの操作の完了を待機する時間。 主にデッドロックを防ぐために使用されます。 既定値は 4 秒です。
- cancellationToken
- CancellationToken
キャンセル要求を監視するためのトークン。 既定値は None です。
戻り値
非同期の読み取り操作を表すタスク。 タスクの結果は、キーが Reliable Dictionary で見つかったかどうか、および見つかった場合は値とシーケンス番号を示すタプルです。
例外
tx が null であるか、null key であるか、シリアル化できません。
timeout が負の値です。
指定されたタイムアウト内に操作を完了できませんでした。
操作は取り消されました。
現在、IReliableDictionary が読み取りを提供できないことを示します。 この例外は、すべて ReplicaRoleでスローできます。 ロールでスローされる理由の 1 つは、 Primary の ReadStatus損失です。 ロールでスローされる理由の ActiveSecondary 1 つは、Reliable Collection の状態がまだ一貫性がないということです。
トランザクションがシステムによって内部的に障害が発生しました。 新しいトランザクションで操作を再試行する
オブジェクトの現在の状態に対してメソッド呼び出しが無効な場合にスローされます。 たとえば、使用されているトランザクションは既に終了しています。ユーザーによってコミットまたは中止されています。 この例外がスローされた場合、トランザクションを使用するサービス コードにバグがある可能性が高くなります。
Reliable Dictionary が閉じられたり削除されたりすることを示します。
適用対象
Azure SDK for .NET