Compartilhar via


ProcessMessageEventArgs.AbandonMessageAsync Método

Definição

Abandona um ServiceBusReceivedMessage. Isso disponibilizará a mensagem novamente para processamento imediato, pois o bloqueio na mensagem mantida pelo receptor será liberado.

public virtual System.Threading.Tasks.Task AbandonMessageAsync (Azure.Messaging.ServiceBus.ServiceBusReceivedMessage message, System.Collections.Generic.IDictionary<string,object> propertiesToModify = default, System.Threading.CancellationToken cancellationToken = default);
abstract member AbandonMessageAsync : Azure.Messaging.ServiceBus.ServiceBusReceivedMessage * System.Collections.Generic.IDictionary<string, obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.AbandonMessageAsync : Azure.Messaging.ServiceBus.ServiceBusReceivedMessage * System.Collections.Generic.IDictionary<string, obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function AbandonMessageAsync (message As ServiceBusReceivedMessage, Optional propertiesToModify As IDictionary(Of String, Object) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Parâmetros

propertiesToModify
IDictionary<String,Object>

As propriedades da mensagem a serem modificadas ao abandonar a mensagem.

cancellationToken
CancellationToken

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

Retornos

Uma tarefa a ser resolvida quando a operação for concluída.

Exceções

  • O bloqueio da mensagem expirou ou a mensagem já foi concluída. Isso não se aplica a entidades habilitadas para sessão. O Reason será definido MessageLockLost como nesse caso.
  • O bloqueio da sessão expirou ou a mensagem já foi concluída. Isso só se aplica a entidades habilitadas para sessão. O Reason será definido SessionLockLost como nesse caso.

Comentários

Abandonar uma mensagem aumentará a contagem de entrega na mensagem. Essa operação só pode ser executada em mensagens recebidas por esse receptor quando ReceiveMode é definida PeekLockcomo .

Aplica-se a