ProcessSessionMessageEventArgs.DeadLetterMessageAsync Méthode

Définition

Espace de noms:

Azure.Messaging.ServiceBus

Assembly:

Azure.Messaging.ServiceBus.dll

Paquet:

Azure.Messaging.ServiceBus v7.17.5

Surcharges

DeadLetterMessageAsync(ServiceBusReceivedMessage, IDictionary<String,Object>, CancellationToken)	Déplace un message vers la sous-file d’attente de lettres mortes.
DeadLetterMessageAsync(ServiceBusReceivedMessage, String, String, CancellationToken)	Déplace un message vers la sous-file d’attente de lettres mortes.
DeadLetterMessageAsync(ServiceBusReceivedMessage, Dictionary<String,Object>, String, String, CancellationToken)	Déplace un message vers la sous-file d’attente de lettres mortes.

DeadLetterMessageAsync(ServiceBusReceivedMessage, IDictionary<String,Object>, CancellationToken)

Source:

ProcessSessionMessageEventArgs.cs

Déplace un message vers la sous-file d’attente de lettres mortes.

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

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

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

Paramètres

message

ServiceBusReceivedMessage

Lettre ServiceBusReceivedMessage morte.

propertiesToModify

IDictionary<String,Object>

Propriétés du message à modifier lors du passage à la sous-file d’attente.

cancellationToken

CancellationToken

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

Retours

Task

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 un message de la file d’attente de lettres mortes ou de transfert de la file d’attente de lettres mortes, définissez la propriété sur SubQueue ou TransferDeadLetter lors de l’appel CreateReceiver(String, ServiceBusReceiverOptions) ou CreateReceiver(String, String, ServiceBusReceiverOptions).DeadLetter Cette opération ne peut être effectuée que si ReceiveMode est défini sur PeekLock.

DeadLetterMessageAsync(ServiceBusReceivedMessage, String, String, CancellationToken)

Source:

ProcessSessionMessageEventArgs.cs

Déplace un message vers la sous-file d’attente de lettres mortes.

public virtual System.Threading.Tasks.Task DeadLetterMessageAsync (Azure.Messaging.ServiceBus.ServiceBusReceivedMessage message, string deadLetterReason, string deadLetterErrorDescription = default, System.Threading.CancellationToken cancellationToken = default);

abstract member DeadLetterMessageAsync : Azure.Messaging.ServiceBus.ServiceBusReceivedMessage * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.DeadLetterMessageAsync : Azure.Messaging.ServiceBus.ServiceBusReceivedMessage * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function DeadLetterMessageAsync (message As ServiceBusReceivedMessage, deadLetterReason As String, Optional deadLetterErrorDescription As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Paramètres

message

ServiceBusReceivedMessage

Lettre ServiceBusReceivedMessage morte.

deadLetterReason

String

Raison de la lettre morte du message.

deadLetterErrorDescription

String

Description de l’erreur pour la lettre morte du message.

cancellationToken

CancellationToken

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

Retours

Task

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.

ArgumentOutOfRangeException

• Le motif de la lettre morte ou la description de l’erreur de lettre morte a dépassé la longueur maximale de 4 096.

Remarques

Pour recevoir un message de la file d’attente de lettres mortes ou de transfert de la file d’attente de lettres mortes, définissez la propriété sur SubQueue ou TransferDeadLetter lors de l’appel CreateReceiver(String, ServiceBusReceiverOptions) ou CreateReceiver(String, String, ServiceBusReceiverOptions).DeadLetter Cette opération ne peut être effectuée que si ReceiveMode est défini sur PeekLock.

DeadLetterMessageAsync(ServiceBusReceivedMessage, Dictionary<String,Object>, String, String, CancellationToken)

Source:

ProcessSessionMessageEventArgs.cs

Déplace un message vers la sous-file d’attente de lettres mortes.

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

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

Public Overridable Function DeadLetterMessageAsync (message As ServiceBusReceivedMessage, propertiesToModify As Dictionary(Of String, Object), deadLetterReason As String, Optional deadLetterErrorDescription As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Paramètres

message

ServiceBusReceivedMessage

Lettre ServiceBusReceivedMessage morte.

propertiesToModify

Dictionary<String,Object>

Propriétés du message à modifier lors du passage à la sous-file d’attente.

deadLetterReason

String

Raison de la lettre morte du message.

deadLetterErrorDescription

String

Description de l’erreur pour la lettre morte du message.

cancellationToken

CancellationToken

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

Retours

Task

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.

InvalidOperationException

• La raison de la lettre morte ou l’exception d’erreur de lettre morte a été spécifiée dans le paramètre et le dictionnaire de propriétés.

ArgumentOutOfRangeException

• Le motif de la lettre morte ou la description de l’erreur de lettre morte a dépassé la longueur maximale de 4 096.

Remarques

Pour recevoir un message de la file d’attente de lettres mortes ou de transfert de la file d’attente de lettres mortes, définissez la propriété sur SubQueue ou TransferDeadLetter lors de l’appel CreateReceiver(String, ServiceBusReceiverOptions) ou CreateReceiver(String, String, ServiceBusReceiverOptions).DeadLetter Cette opération ne peut être effectuée que si ReceiveMode est défini sur PeekLock. La raison de la lettre morte et la description de l’erreur ne peuvent être spécifiées que par le biais des paramètres de la méthode ou codées en dur à l’aide de ces propriétés.