Partager via


ProcessMessageEventArgs.AbandonMessageAsync Méthode

Définition

Abandonne un ServiceBusReceivedMessage. Cela rend le message à nouveau disponible pour un traitement immédiat, car le verrou sur le message détenu par le destinataire sera libéré.

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

Paramètres

propertiesToModify
IDictionary<String,Object>

Propriétés du message à modifier lors de l’abandon du message.

cancellationToken
CancellationToken

Une instance facultative CancellationToken pour signaler la demande d’annulation de l’opération.

Retours

Tâche à résoudre lorsque l’opération est terminée.

Exceptions

  • Le verrou du message a expiré ou le message a déjà été terminé. Cela ne s’applique pas aux entités avec session. Reason le sera défini sur MessageLockLost dans ce cas.
  • Le verrou de la session a expiré ou le message est déjà terminé. Cela s’applique uniquement aux entités prenant en charge la session. Reason le sera défini sur SessionLockLost dans ce cas.

Remarques

L’abandon d’un message augmente le nombre de remises sur le message. Cette opération ne peut être effectuée que sur les messages qui ont été reçus par ce récepteur lorsque ReceiveMode est défini sur PeekLock.

S’applique à