你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ServiceBusSender.ScheduleMessagesAsync 方法

定义

命名空间:

Azure.Messaging.ServiceBus

程序集:

Azure.Messaging.ServiceBus.dll

包:

Azure.Messaging.ServiceBus v7.17.0

计划稍后在服务总线上显示的一组消息。

public virtual System.Threading.Tasks.Task<System.Collections.Generic.IReadOnlyList<long>> ScheduleMessagesAsync (System.Collections.Generic.IEnumerable<Azure.Messaging.ServiceBus.ServiceBusMessage> messages, DateTimeOffset scheduledEnqueueTime, System.Threading.CancellationToken cancellationToken = default);

abstract member ScheduleMessagesAsync : seq<Azure.Messaging.ServiceBus.ServiceBusMessage> * DateTimeOffset * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Collections.Generic.IReadOnlyList<int64>>
override this.ScheduleMessagesAsync : seq<Azure.Messaging.ServiceBus.ServiceBusMessage> * DateTimeOffset * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Collections.Generic.IReadOnlyList<int64>>

Public Overridable Function ScheduleMessagesAsync (messages As IEnumerable(Of ServiceBusMessage), scheduledEnqueueTime As DateTimeOffset, Optional cancellationToken As CancellationToken = Nothing) As Task(Of IReadOnlyList(Of Long))

参数

messages

IEnumerable<ServiceBusMessage>

要计划的消息集。

scheduledEnqueueTime

DateTimeOffset

消息应可用于处理的 UTC 时间

cancellationToken

CancellationToken

一个可选 CancellationToken 实例，用于发出取消操作的请求信号。

返回

Task<IReadOnlyList<Int64>>

已计划的消息的序列号。

例外

SerializationException

当其中 messages 一个 在其 ApplicationProperties 集合中具有不受支持的序列化类型的成员时发生。 有关详细信息， ApplicationProperties 请参阅备注。

注解

尽管在 scheduledEnqueueTime 之前无法接收该消息，但仍可以在该时间之前查看该消息。 还可以通过设置 ScheduledEnqueueTime 和使用 SendMessageAsync(ServiceBusMessage, CancellationToken)、 SendMessagesAsync(IEnumerable<ServiceBusMessage>, CancellationToken)或 SendMessagesAsync(ServiceBusMessageBatch, CancellationToken)来计划消息。

另请参阅

• CancelScheduledMessagesAsync(IEnumerable<Int64>, CancellationToken)