ServiceBusClient.AcceptNextSessionAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| AcceptNextSessionAsync(String, ServiceBusSessionReceiverOptions, CancellationToken) |
アクティブ メッセージを ServiceBusSessionReceiver 含む次のロック解除されたセッションを受け入れることで、セッションが有効なキューからのメッセージの受信と解決に使用できるインスタンスを作成します。 アクティブ メッセージを含むロック解除されたセッションがない場合、構成されたTryTimeout値の後に呼び出しがタイムアウトし、 が にServiceTimeout設定された をServiceBusExceptionReasonスローします。 で ServiceBusReceiveMode を指定 ServiceBusReceiverOptions して、メッセージの受信方法を構成できます。 既定値は PeekLock です。 |
| AcceptNextSessionAsync(String, String, ServiceBusSessionReceiverOptions, CancellationToken) |
アクティブ メッセージを ServiceBusSessionReceiver 含む次のロック解除されたセッションを受け入れることで、セッションが有効なサブスクリプションからのメッセージの受信と決済に使用できるインスタンスを作成します。 アクティブ メッセージを含むロック解除されたセッションがない場合、構成されたTryTimeout値の後に呼び出しがタイムアウトし、 が にServiceTimeout設定された をServiceBusExceptionReasonスローします。 で ServiceBusReceiveMode を指定 ServiceBusReceiverOptions して、メッセージの受信方法を構成できます。 既定値は PeekLock です。 |
AcceptNextSessionAsync(String, ServiceBusSessionReceiverOptions, CancellationToken)
アクティブ メッセージを ServiceBusSessionReceiver 含む次のロック解除されたセッションを受け入れることで、セッションが有効なキューからのメッセージの受信と解決に使用できるインスタンスを作成します。 アクティブ メッセージを含むロック解除されたセッションがない場合、構成されたTryTimeout値の後に呼び出しがタイムアウトし、 が にServiceTimeout設定された をServiceBusExceptionReasonスローします。 で ServiceBusReceiveMode を指定 ServiceBusReceiverOptions して、メッセージの受信方法を構成できます。 既定値は PeekLock です。
public virtual System.Threading.Tasks.Task<Azure.Messaging.ServiceBus.ServiceBusSessionReceiver> AcceptNextSessionAsync (string queueName, Azure.Messaging.ServiceBus.ServiceBusSessionReceiverOptions options = default, System.Threading.CancellationToken cancellationToken = default);abstract member AcceptNextSessionAsync : string * Azure.Messaging.ServiceBus.ServiceBusSessionReceiverOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Messaging.ServiceBus.ServiceBusSessionReceiver>
override this.AcceptNextSessionAsync : string * Azure.Messaging.ServiceBus.ServiceBusSessionReceiverOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Messaging.ServiceBus.ServiceBusSessionReceiver>Public Overridable Function AcceptNextSessionAsync (queueName As String, Optional options As ServiceBusSessionReceiverOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ServiceBusSessionReceiver)パラメーター
- queueName
- String
を作成するセッションが有効な ServiceBusSessionReceiver キュー。
- options
- ServiceBusSessionReceiverOptions
を構成するために使用する のServiceBusSessionReceiverセットServiceBusSessionReceiverOptions。
- cancellationToken
- CancellationToken
操作を取り消す要求を通知する省略可能 CancellationToken な インスタンス。
戻り値
ServiceBusSessionReceiver指定したキューと特定のセッションを対象とした 。
例外
エンティティにロック解除されたセッションはありません。 これは、エンティティにアクティブなメッセージがない場合、またはすべてのメッセージが他の受信者によってロックされているセッションに属している場合に発生する可能性があります。 Reasonこの場合、 は にServiceTimeout設定されます。
注釈
これによりセッション ロックが確立されるため、このメソッドはサービス呼び出しを実行します。 キューに使用可能なメッセージがない場合は、 で が ServiceBusExceptionReasonServiceTimeoutスローされます。
適用対象
AcceptNextSessionAsync(String, String, ServiceBusSessionReceiverOptions, CancellationToken)
アクティブ メッセージを ServiceBusSessionReceiver 含む次のロック解除されたセッションを受け入れることで、セッションが有効なサブスクリプションからのメッセージの受信と決済に使用できるインスタンスを作成します。 アクティブ メッセージを含むロック解除されたセッションがない場合、構成されたTryTimeout値の後に呼び出しがタイムアウトし、 が にServiceTimeout設定された をServiceBusExceptionReasonスローします。 で ServiceBusReceiveMode を指定 ServiceBusReceiverOptions して、メッセージの受信方法を構成できます。 既定値は PeekLock です。
public virtual System.Threading.Tasks.Task<Azure.Messaging.ServiceBus.ServiceBusSessionReceiver> AcceptNextSessionAsync (string topicName, string subscriptionName, Azure.Messaging.ServiceBus.ServiceBusSessionReceiverOptions options = default, System.Threading.CancellationToken cancellationToken = default);abstract member AcceptNextSessionAsync : string * string * Azure.Messaging.ServiceBus.ServiceBusSessionReceiverOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Messaging.ServiceBus.ServiceBusSessionReceiver>
override this.AcceptNextSessionAsync : string * string * Azure.Messaging.ServiceBus.ServiceBusSessionReceiverOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Messaging.ServiceBus.ServiceBusSessionReceiver>Public Overridable Function AcceptNextSessionAsync (topicName As String, subscriptionName As String, Optional options As ServiceBusSessionReceiverOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ServiceBusSessionReceiver)パラメーター
- topicName
- String
を作成 ServiceBusSessionReceiver するトピック。
- subscriptionName
- String
を作成するセッションが有効な ServiceBusSessionReceiver サブスクリプション。
- options
- ServiceBusSessionReceiverOptions
を構成するために使用する のServiceBusSessionReceiverセットServiceBusSessionReceiverOptions。
- cancellationToken
- CancellationToken
操作を取り消す要求を通知する省略可能 CancellationToken な インスタンス。
戻り値
ServiceBusSessionReceiver指定したキューと特定のセッションを対象とした 。
例外
エンティティにロック解除されたセッションはありません。 これは、エンティティにメッセージがない場合、またはすべてのメッセージが他の受信者によってロックされているセッションに属している場合に発生する可能性があります。 Reasonこの場合、 は にServiceTimeout設定されます。
注釈
これによりセッション ロックが確立されるため、このメソッドはサービス呼び出しを実行します。 キューに使用可能なメッセージがない場合は、 で が ServiceBusExceptionReasonServiceTimeoutスローされます。
適用対象
Azure SDK for .NET