Compartilhar via


ServiceBusSender.ScheduleMessageAsync Método

Definição

Agenda uma mensagem para aparecer no Barramento de Serviço posteriormente.

public virtual System.Threading.Tasks.Task<long> ScheduleMessageAsync (Azure.Messaging.ServiceBus.ServiceBusMessage message, DateTimeOffset scheduledEnqueueTime, System.Threading.CancellationToken cancellationToken = default);
abstract member ScheduleMessageAsync : Azure.Messaging.ServiceBus.ServiceBusMessage * DateTimeOffset * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.ScheduleMessageAsync : Azure.Messaging.ServiceBus.ServiceBusMessage * DateTimeOffset * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
Public Overridable Function ScheduleMessageAsync (message As ServiceBusMessage, scheduledEnqueueTime As DateTimeOffset, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Long)

Parâmetros

message
ServiceBusMessage

O ServiceBusMessage a ser agendado.

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 o message 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).

Aplica-se a

Confira também