Freigeben über


ServiceBusReceiver.DeadLetterMessageAsync Methode

Definition

Überlädt

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

Verschiebt eine Nachricht in die Unterwarteschlange für unzustellbare Nachrichten.

DeadLetterMessageAsync(ServiceBusReceivedMessage, String, String, CancellationToken)

Verschiebt eine Nachricht in die Unterwarteschlange für unzustellbare Nachrichten.

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

Verschiebt eine Nachricht in die Unterwarteschlange für unzustellbare Nachrichten.

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

Quelle:
ServiceBusReceiver.cs
Quelle:
ServiceBusReceiver.cs

Verschiebt eine Nachricht in die Unterwarteschlange für unzustellbare Nachrichten.

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

Parameter

propertiesToModify
IDictionary<String,Object>

Die Eigenschaften der Nachricht, die beim Verschieben in die Unterwarteschlange geändert werden soll.

cancellationToken
CancellationToken

Ein optionaler CancellationToken instance, um der Anforderung zu signalisieren, den Vorgang abzubrechen.

Gibt zurück

Ausnahmen

  • Die Sperre für die Nachricht ist abgelaufen, oder die Nachricht wurde bereits abgeschlossen. Dies gilt nicht für sitzungsfähige Entitäten. Wird Reason in diesem Fall auf MessageLockLost festgelegt.
  • Die Sperre für die Sitzung ist abgelaufen, oder die Nachricht wurde bereits abgeschlossen. Dies gilt nur für sitzungsfähige Entitäten. Wird Reason in diesem Fall auf SessionLockLost festgelegt.

Hinweise

Um eine Nachricht aus der Warteschlange für unzustellbare Nachrichten zu empfangen oder die Warteschlange für unzustellbare Nachrichten zu übertragen, legen Sie die SubQueue -Eigenschaft auf DeadLetter oder TransferDeadLetter fest, wenn Sie oder CreateReceiver(String, String, ServiceBusReceiverOptions)aufrufenCreateReceiver(String, ServiceBusReceiverOptions). Dieser Vorgang kann nur ausgeführt werden, wenn ReceiveMode auf PeekLockfestgelegt ist.

Gilt für:

DeadLetterMessageAsync(ServiceBusReceivedMessage, String, String, CancellationToken)

Quelle:
ServiceBusReceiver.cs
Quelle:
ServiceBusReceiver.cs

Verschiebt eine Nachricht in die Unterwarteschlange für unzustellbare Nachrichten.

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

Parameter

deadLetterReason
String

Der Grund für die Unzustellbare Nachricht.

deadLetterErrorDescription
String

Die Fehlerbeschreibung für das Unzustellbare Schreiben der Nachricht.

cancellationToken
CancellationToken

Ein optionaler CancellationToken instance, um der Anforderung zu signalisieren, den Vorgang abzubrechen.

Gibt zurück

Ausnahmen

  • Die Sperre für die Nachricht ist abgelaufen, oder die Nachricht wurde bereits abgeschlossen. Dies gilt nicht für sitzungsfähige Entitäten. Wird Reason in diesem Fall auf MessageLockLost festgelegt.
  • Die Sperre für die Sitzung ist abgelaufen, oder die Nachricht wurde bereits abgeschlossen. Dies gilt nur für sitzungsfähige Entitäten. Wird Reason in diesem Fall auf SessionLockLost festgelegt.
  • Die Fehlerbeschreibung für unzustellbare Nachrichten oder unzustellbare Nachrichten hat die maximale Länge von 4096 überschritten.

Hinweise

Um eine Nachricht aus der Warteschlange für unzustellbare Nachrichten zu empfangen oder die Warteschlange für unzustellbare Nachrichten zu übertragen, legen Sie die SubQueue -Eigenschaft auf DeadLetter oder TransferDeadLetter fest, wenn Sie oder CreateReceiver(String, String, ServiceBusReceiverOptions)aufrufenCreateReceiver(String, ServiceBusReceiverOptions). Dieser Vorgang kann nur ausgeführt werden, wenn ReceiveMode auf PeekLockfestgelegt ist.

Gilt für:

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

Quelle:
ServiceBusReceiver.cs
Quelle:
ServiceBusReceiver.cs

Verschiebt eine Nachricht in die Unterwarteschlange für unzustellbare Nachrichten.

public virtual System.Threading.Tasks.Task DeadLetterMessageAsync (Azure.Messaging.ServiceBus.ServiceBusReceivedMessage message, System.Collections.Generic.IDictionary<string,object> propertiesToModify, string deadLetterReason, string deadLetterErrorDescription = default, System.Threading.CancellationToken cancellationToken = default);
abstract member DeadLetterMessageAsync : Azure.Messaging.ServiceBus.ServiceBusReceivedMessage * System.Collections.Generic.IDictionary<string, obj> * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.DeadLetterMessageAsync : Azure.Messaging.ServiceBus.ServiceBusReceivedMessage * System.Collections.Generic.IDictionary<string, obj> * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function DeadLetterMessageAsync (message As ServiceBusReceivedMessage, propertiesToModify As IDictionary(Of String, Object), deadLetterReason As String, Optional deadLetterErrorDescription As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

propertiesToModify
IDictionary<String,Object>

Die Eigenschaften der Nachricht, die beim Verschieben in die Unterwarteschlange geändert werden soll.

deadLetterReason
String

Der Grund für die Unzustellbare Nachricht.

deadLetterErrorDescription
String

Die Fehlerbeschreibung für das Unzustellbare Schreiben der Nachricht.

cancellationToken
CancellationToken

Ein optionaler CancellationToken instance, um der Anforderung zu signalisieren, den Vorgang abzubrechen.

Gibt zurück

Ausnahmen

  • Die Sperre für die Nachricht ist abgelaufen, oder die Nachricht wurde bereits abgeschlossen. Dies gilt nicht für sitzungsfähige Entitäten. Wird Reason in diesem Fall auf MessageLockLost festgelegt.
  • Die Sperre für die Sitzung ist abgelaufen, oder die Nachricht wurde bereits abgeschlossen. Dies gilt nur für sitzungsfähige Entitäten. Wird Reason in diesem Fall auf SessionLockLost festgelegt.
  • Der Grund für unzustellbare Nachrichten oder fehlerfehler wurde sowohl im Parameter als auch im Eigenschaftenwörterbuch angegeben.
  • Die Fehlerbeschreibung für unzustellbare Nachrichten oder unzustellbare Nachrichten hat die maximale Länge von 4096 überschritten.

Hinweise

Um eine Nachricht aus der Warteschlange für unzustellbare Nachrichten zu empfangen oder die Warteschlange für unzustellbare Nachrichten zu übertragen, legen Sie die SubQueue -Eigenschaft auf DeadLetter oder TransferDeadLetter fest, wenn Sie oder CreateReceiver(String, String, ServiceBusReceiverOptions)aufrufenCreateReceiver(String, ServiceBusReceiverOptions). Dieser Vorgang kann nur ausgeführt werden, wenn ReceiveMode auf PeekLockfestgelegt ist. Ursache und Fehlerbeschreibung für unzustellbare Nachrichten können nur über die Methodenparameter angegeben oder mit diesen Eigenschaften hartcodiert werden.

Gilt für: