ServiceBusClient.AcceptNextSessionAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- 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
Um ServiceBusSessionReceiver escopo para a fila especificada e uma sessão específica.
Exceções
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.
Aplica-se a
AcceptNextSessionAsync(String, String, ServiceBusSessionReceiverOptions, CancellationToken)
- Origem:
- ServiceBusClient.cs
- 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
Um ServiceBusSessionReceiver escopo para a fila especificada e uma sessão específica.
Exceções
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.
Aplica-se a
Azure SDK for .NET