你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
ServiceBusReceiver.PeekMessageAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提取下一个活动状态 ServiceBusReceivedMessage ,而不更改接收方或消息源的状态。
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)
参数
从中查看消息的可选序列号。 这对应于 SequenceNumber。
- cancellationToken
- CancellationToken
一个可选 CancellationToken 实例,用于发出取消操作的请求信号。
返回
表示 ServiceBusReceivedMessage 要读取的下一条消息的 。 当无可窥视时返回 null。
注解
对 的第一次调用 PeekMessageAsync(Nullable<Int64>, CancellationToken) 将提取此接收方的第一条活动消息。 每个后续调用都会提取实体中的后续消息。 与收到的消息不同,速览消息不会与它关联锁定令牌,因此它不能为 Completed/Abandoned/Deferred/Deadlettered/Renewed。 此外,与 不同 ReceiveMessageAsync(Nullable<TimeSpan>, CancellationToken),此方法甚至会提取 (的延迟消息,但不会提取死信) 。