Freigeben über

ServiceBusReceiver.DeferMessageAsync Methode

  • Referenz

Definition

Namespace:
Azure.Messaging.ServiceBus
Assembly:
Azure.Messaging.ServiceBus.dll
Paket:
Azure.Messaging.ServiceBus v7.17.5
Paket:
Azure.Messaging.ServiceBus v7.18.0-beta.1
Quelle:
ServiceBusReceiver.cs
Quelle:
ServiceBusReceiver.cs

Gibt an, dass der Empfänger die Verarbeitung für die Nachricht zurückstellen möchte.

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

Parameter

message
ServiceBusReceivedMessage

Die ServiceBusReceivedMessage zurückstellende.

propertiesToModify
IDictionary<String,Object>

Die Eigenschaften der Nachricht, die beim Zurückstellen der Nachricht geändert werden soll.

cancellationToken
CancellationToken

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

Gibt zurück

Task

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

Ausnahmen

ServiceBusException
  • 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

Um diese Nachricht in Zukunft erneut zu erhalten, müssen Sie die SequenceNumber speichern und mit ReceiveDeferredMessageAsync(Int64, CancellationToken)empfangen. Das Zurückstellen von Nachrichten wirkt sich nicht auf den Ablauf der Nachricht aus, was bedeutet, dass verzögerte Nachrichten weiterhin ablaufen können. Dieser Vorgang kann nur für Nachrichten ausgeführt werden, die von diesem Empfänger empfangen wurden.

Gilt für: