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