ServiceBusReceiver.AbandonMessageAsync Método

Definição

Namespace:

Azure.Messaging.ServiceBus

Assembly:

Azure.Messaging.ServiceBus.dll

Pacote:

Azure.Messaging.ServiceBus v7.17.5

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 .