ServiceBusClient.AcceptNextSessionAsync メソッド

定義

名前空間:

Azure.Messaging.ServiceBus

アセンブリ:

Azure.Messaging.ServiceBus.dll

パッケージ:

Azure.Messaging.ServiceBus v7.17.5

オーバーロード

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)

Source:

ServiceBusClient.cs

アクティブ メッセージを 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 な インスタンス。

戻り値

Task<ServiceBusSessionReceiver>

ServiceBusSessionReceiver指定したキューと特定のセッションを対象とした 。

例外

ServiceBusException

エンティティにロック解除されたセッションはありません。 これは、エンティティにアクティブなメッセージがない場合、またはすべてのメッセージが他の受信者によってロックされているセッションに属している場合に発生する可能性があります。 Reasonこの場合、 は にServiceTimeout設定されます。

注釈

これによりセッション ロックが確立されるため、このメソッドはサービス呼び出しを実行します。 キューに使用可能なメッセージがない場合は、 で が ServiceBusExceptionReasonServiceTimeoutスローされます。

AcceptNextSessionAsync(String, String, ServiceBusSessionReceiverOptions, CancellationToken)

Source:

ServiceBusClient.cs

アクティブ メッセージを 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 な インスタンス。

戻り値

Task<ServiceBusSessionReceiver>

ServiceBusSessionReceiver指定したキューと特定のセッションを対象とした 。

例外

ServiceBusException

エンティティにロック解除されたセッションはありません。 これは、エンティティにメッセージがない場合、またはすべてのメッセージが他の受信者によってロックされているセッションに属している場合に発生する可能性があります。 Reasonこの場合、 は にServiceTimeout設定されます。

注釈

これによりセッション ロックが確立されるため、このメソッドはサービス呼び出しを実行します。 キューに使用可能なメッセージがない場合は、 で が ServiceBusExceptionReasonServiceTimeoutスローされます。