ServiceBusReceiver.PeekMessageAsync 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.
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
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:
Azure SDK for .NET