ServiceBusReceiver.DeadLetterMessageAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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
- message
- ServiceBusReceivedMessage
Der ServiceBusReceivedMessage to dead-letter.
- 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
- message
- ServiceBusReceivedMessage
Der ServiceBusReceivedMessage to dead-letter.
- 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
- message
- ServiceBusReceivedMessage
Der ServiceBusReceivedMessage to dead-letter.
- 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:
Azure SDK for .NET