ProcessSessionMessageEventArgs.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:: ProcessSessionMessageEventArgs.cs

Quelle:: ProcessSessionMessageEventArgs.cs

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.

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:

Freigeben über