Share via


ServiceBusReceiver.PeekMessageAsync Methode

Definition

Ruft den nächsten aktiven ServiceBusReceivedMessage Ab, ohne den Status des Empfängers oder der Nachrichtenquelle zu ändern.

public virtual System.Threading.Tasks.Task<Azure.Messaging.ServiceBus.ServiceBusReceivedMessage> PeekMessageAsync (long? fromSequenceNumber = default, System.Threading.CancellationToken cancellationToken = default);
abstract member PeekMessageAsync : Nullable<int64> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Messaging.ServiceBus.ServiceBusReceivedMessage>
override this.PeekMessageAsync : Nullable<int64> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Messaging.ServiceBus.ServiceBusReceivedMessage>
Public Overridable Function PeekMessageAsync (Optional fromSequenceNumber As Nullable(Of Long) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ServiceBusReceivedMessage)

Parameter

fromSequenceNumber
Nullable<Int64>

Eine optionale Sequenznummer, von der aus die Nachricht angezeigt werden soll. Dies entspricht dem SequenceNumber.

cancellationToken
CancellationToken

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

Gibt zurück

Die ServiceBusReceivedMessage , die die nächste zu lesende Nachricht darstellt. Gibt NULL zurück, wenn nichts eingesehen werden soll.

Hinweise

Der erste Aufruf von ruft PeekMessageAsync(Nullable<Int64>, CancellationToken) die erste aktive Nachricht für diesen Empfänger ab. Jeder nachfolgende Aufruf ruft die nachfolgende Nachricht in der Entität ab. Im Gegensatz zu einer empfangenen Nachricht ist einer eingesehenen Nachricht kein Sperrtoken zugeordnet, und daher kann sie nicht abgeschlossen/aufgegeben/verzögert/deadlettered/Erneuert werden. Außerdem ruft diese Methode im Gegensatz zu ReceiveMessageAsync(Nullable<TimeSpan>, CancellationToken), sogar verzögerte Nachrichten (aber keine Unzustellbare Nachricht) ab.

Gilt für: