ServiceBusSender.ScheduleMessagesAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Agenda um conjunto de mensagens para aparecer no Barramento de Serviço posteriormente.
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))Parâmetros
- messages
- IEnumerable<ServiceBusMessage>
O conjunto de mensagens a serem agendadas.
- scheduledEnqueueTime
- DateTimeOffset
A hora UTC em que a mensagem deve estar disponível para processamento
- cancellationToken
- CancellationToken
Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.
Retornos
O número de sequência da mensagem que foi agendada.
Exceções
Ocorre quando um dos messages tem um membro em sua ApplicationProperties coleção que é um tipo sem suporte para serialização. Confira os ApplicationProperties comentários para obter detalhes.
Comentários
Embora a mensagem não esteja disponível para ser recebida até o scheduledEnqueueTime, ela ainda pode ser espiada antes desse horário. As mensagens também podem ser agendadas definindo ScheduledEnqueueTime e usando SendMessageAsync(ServiceBusMessage, CancellationToken), SendMessagesAsync(IEnumerable<ServiceBusMessage>, CancellationToken)ou SendMessagesAsync(ServiceBusMessageBatch, CancellationToken).