ServiceBusSender.ScheduleMessageAsync Método

Definição

Namespace:

Azure.Messaging.ServiceBus

Assembly:

Azure.Messaging.ServiceBus.dll

Pacote:

Azure.Messaging.ServiceBus v7.17.5

Origem:

ServiceBusSender.cs

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

Task<Int64>

O número de sequência da mensagem que foi agendada.

Exceções

SerializationException

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

Confira também

• CancelScheduledMessageAsync(Int64, CancellationToken)