ServiceBusClient.AcceptNextSessionAsync Método

Definição

Namespace:

Azure.Messaging.ServiceBus

Assembly:

Azure.Messaging.ServiceBus.dll

Pacote:

Azure.Messaging.ServiceBus v7.17.5

Sobrecargas

AcceptNextSessionAsync(String, ServiceBusSessionReceiverOptions, CancellationToken)

Cria uma ServiceBusSessionReceiver instância que pode ser usada para receber e resolver mensagens de uma fila habilitada para sessão aceitando a próxima sessão desbloqueada que contém mensagens Ativas. Se não houver sessões desbloqueadas com mensagens ativas, a chamada terá o tempo limite após o valor configurado TryTimeout e lançará um ServiceBusException com definido ServiceTimeoutcomo Reason . O ServiceBusReceiveMode pode ser especificado no para configurar como as ServiceBusReceiverOptions mensagens são recebidas. O valor padrão é PeekLock.

AcceptNextSessionAsync(String, String, ServiceBusSessionReceiverOptions, CancellationToken)

Cria uma ServiceBusSessionReceiver instância que pode ser usada para receber e resolver mensagens de uma assinatura habilitada para sessão aceitando a próxima sessão desbloqueada que contém mensagens Ativas. Se não houver sessões desbloqueadas com mensagens ativas, a chamada terá o tempo limite após o valor configurado TryTimeout e lançará um ServiceBusException com definido ServiceTimeoutcomo Reason . O ServiceBusReceiveMode pode ser especificado no para configurar como as ServiceBusReceiverOptions mensagens são recebidas. O valor padrão é PeekLock.

AcceptNextSessionAsync(String, ServiceBusSessionReceiverOptions, CancellationToken)

Origem:

ServiceBusClient.cs

Cria uma ServiceBusSessionReceiver instância que pode ser usada para receber e resolver mensagens de uma fila habilitada para sessão aceitando a próxima sessão desbloqueada que contém mensagens Ativas. Se não houver sessões desbloqueadas com mensagens ativas, a chamada terá o tempo limite após o valor configurado TryTimeout e lançará um ServiceBusException com definido ServiceTimeoutcomo Reason . O ServiceBusReceiveMode pode ser especificado no para configurar como as ServiceBusReceiverOptions mensagens são recebidas. O valor padrão é 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)

Parâmetros

queueName

String

A fila habilitada para sessão para a qual criar um ServiceBusSessionReceiver .

options

ServiceBusSessionReceiverOptions

O conjunto de ServiceBusSessionReceiverOptions a ser usado para configurar o ServiceBusSessionReceiver.

cancellationToken

CancellationToken

Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.

Retornos

Task<ServiceBusSessionReceiver>

Um ServiceBusSessionReceiver escopo para a fila especificada e uma sessão específica.

Exceções

ServiceBusException

Não há sessões desbloqueadas na entidade. Isso poderá ocorrer se a entidade não tiver mensagens Ativas ou se todas as mensagens pertencerem a sessões bloqueadas por outros receptores. O Reason será definido ServiceTimeout como nesse caso.

Comentários

Como isso está estabelecendo um bloqueio de sessão, esse método executa uma chamada de serviço. Se não houver mensagens disponíveis na fila, isso gerará um ServiceBusException com Reason de ServiceTimeout.

AcceptNextSessionAsync(String, String, ServiceBusSessionReceiverOptions, CancellationToken)

Origem:

ServiceBusClient.cs

Cria uma ServiceBusSessionReceiver instância que pode ser usada para receber e resolver mensagens de uma assinatura habilitada para sessão aceitando a próxima sessão desbloqueada que contém mensagens Ativas. Se não houver sessões desbloqueadas com mensagens ativas, a chamada terá o tempo limite após o valor configurado TryTimeout e lançará um ServiceBusException com definido ServiceTimeoutcomo Reason . O ServiceBusReceiveMode pode ser especificado no para configurar como as ServiceBusReceiverOptions mensagens são recebidas. O valor padrão é 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)

Parâmetros

topicName

String

O tópico para o qual criar um ServiceBusSessionReceiver .

subscriptionName

String

A assinatura habilitada para sessão para a qual criar um ServiceBusSessionReceiver .

options

ServiceBusSessionReceiverOptions

O conjunto de ServiceBusSessionReceiverOptions a ser usado para configurar o ServiceBusSessionReceiver.

cancellationToken

CancellationToken

Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.

Retornos

Task<ServiceBusSessionReceiver>

Um ServiceBusSessionReceiver escopo para a fila especificada e uma sessão específica.

Exceções

ServiceBusException

Não há sessões desbloqueadas na entidade. Isso poderá ocorrer se a entidade não tiver mensagens ou se todas as mensagens pertencerem a sessões bloqueadas por outros receptores. O Reason será definido ServiceTimeout como nesse caso.

Comentários

Como isso está estabelecendo um bloqueio de sessão, esse método executa uma chamada de serviço. Se não houver mensagens disponíveis na fila, isso gerará um ServiceBusException com Reason de ServiceTimeout.