Freigeben über


ServiceBusReceiver.AbandonMessageAsync Methode

Definition

Gibt ein ServiceBusReceivedMessageauf. Dadurch wird die Nachricht wieder für die sofortige Verarbeitung verfügbar gemacht, da die Sperre für die vom Empfänger gespeicherte Nachricht aufgehoben wird.

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

Parameter

propertiesToModify
IDictionary<String,Object>

Die Eigenschaften der Nachricht, die beim Abbrechen der Nachricht geändert werden soll.

cancellationToken
CancellationToken

Ein optionaler CancellationToken instance, um die Anforderung zum Abbrechen des Vorgangs zu signalisieren.

Gibt zurück

Eine Aufgabe, die nach Abschluss des Vorgangs aufgelöst werden soll.

Ausnahmen

  • Die Sperre für die Nachricht ist abgelaufen, oder die Nachricht wurde bereits abgeschlossen. Dies gilt nicht für sitzungsfähige Entitäten. In Reason diesem Fall wird 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. In Reason diesem Fall wird auf SessionLockLost festgelegt.

Hinweise

Wenn Sie eine Nachricht abbrechen, wird die Anzahl der Zustellungen für die Nachricht erhöht. Dieser Vorgang kann nur für Nachrichten ausgeführt werden, die von diesem Empfänger empfangen wurden, wenn ReceiveMode auf PeekLockfestgelegt ist.

Gilt für: