ServiceBusReceiver.DeferMessageAsync Méthode

Définition

Espace de noms:

Azure.Messaging.ServiceBus

Assembly:

Azure.Messaging.ServiceBus.dll

Paquet:

Azure.Messaging.ServiceBus v7.18.4

Source:

ServiceBusReceiver.cs

Indique que le destinataire souhaite différer le traitement du message.

public virtual System.Threading.Tasks.Task DeferMessageAsync(Azure.Messaging.ServiceBus.ServiceBusReceivedMessage message, System.Collections.Generic.IDictionary<string,object> propertiesToModify = default, System.Threading.CancellationToken cancellationToken = default);

abstract member DeferMessageAsync : Azure.Messaging.ServiceBus.ServiceBusReceivedMessage * System.Collections.Generic.IDictionary<string, obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.DeferMessageAsync : Azure.Messaging.ServiceBus.ServiceBusReceivedMessage * System.Collections.Generic.IDictionary<string, obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function DeferMessageAsync (message As ServiceBusReceivedMessage, Optional propertiesToModify As IDictionary(Of String, Object) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Paramètres

message

ServiceBusReceivedMessage

ServiceBusReceivedMessage à reporter.

propertiesToModify

IDictionary<String,Object>

Propriétés du message à modifier lors du report du message.

cancellationToken

CancellationToken

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

Retours

Task

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

Exceptions

ServiceBusException

• 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

Pour recevoir ce message à nouveau à l’avenir, vous devez enregistrer et le recevoir à l’aide ReceiveDeferredMessageAsync(Int64, CancellationToken)de SequenceNumber . Le report de messages n’a pas d’impact sur l’expiration du message, ce qui signifie que les messages différés peuvent toujours expirer. Cette opération ne peut être effectuée que sur les messages qui ont été reçus par ce récepteur.