ServiceBusReceiver.AbandonMessageAsync Método

  • Referência

Definição

Namespace:
Azure.Messaging.ServiceBus
Assembly:
Azure.Messaging.ServiceBus.dll
Pacote:
Azure.Messaging.ServiceBus v7.17.5
Pacote:
Azure.Messaging.ServiceBus v7.18.0-beta.1
Origem:
ServiceBusReceiver.cs
Origem:
ServiceBusReceiver.cs

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

message
ServiceBusReceivedMessage

O ServiceBusReceivedMessage a ser abandonado.

propertiesToModify
IDictionary<String,Object>

As propriedades da mensagem a ser modificada ao abandonar a mensagem.

cancellationToken
CancellationToken

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

Retornos

Task

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

Exceções

ServiceBusException
  • 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 como MessageLockLost neste 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 como SessionLockLost neste 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