Compartilhar via


ServiceBusSender Classe

Definição

Um cliente responsável por enviar ServiceBusMessage para uma entidade específica do Barramento de Serviço (Fila ou Tópico). Ele pode ser usado para entidades de sessão e não de sessão. Ele é construído chamando CreateSender(String).

public class ServiceBusSender : IAsyncDisposable
type ServiceBusSender = class
    interface IAsyncDisposable
Public Class ServiceBusSender
Implements IAsyncDisposable
Herança
ServiceBusSender
Implementações

Comentários

O ServiceBusSender é seguro para armazenar em cache e usar durante o tempo de vida de um aplicativo ou até que o ServiceBusClient pelo qual ele foi criado seja descartado. O cache do remetente é recomendado quando o aplicativo está publicando mensagens regularmente ou semestralmente. O remetente é responsável por garantir o uso eficiente de rede, CPU e memória. Chamar DisposeAsync() o associado ServiceBusClient como o aplicativo está sendo desligado garantirá que os recursos de rede e outros objetos não gerenciados usados pelo remetente sejam devidamente limpos.

Construtores

ServiceBusSender()

Inicializa uma nova instância da ServiceBusSender classe para zombar.

ServiceBusSender(ServiceBusClient, String)

Inicializa uma nova instância da ServiceBusSender classe para uso com tipos derivados.

ServiceBusSender(ServiceBusClient, String, ServiceBusSenderOptions)

Inicializa uma nova instância da ServiceBusSender classe para uso com tipos derivados.

Propriedades

EntityPath

O caminho da entidade à qual o remetente está conectado, específico ao namespace do Barramento de Serviço que o contém.

FullyQualifiedNamespace

O namespace do Barramento de Serviço totalmente qualificado ao qual o produtor está associado. É provável que isso seja semelhante a {yournamespace}.servicebus.windows.net.

Identifier

Obtém a ID para identificar esse cliente. Isso pode ser usado para correlacionar logs e exceções.

IsClosed

Indica se isso ServiceBusSender foi ou não fechado.

Métodos

CancelScheduledMessageAsync(Int64, CancellationToken)

Cancela uma mensagem que foi agendada.

CancelScheduledMessagesAsync(IEnumerable<Int64>, CancellationToken)

Cancela um conjunto de mensagens que foram agendadas.

CloseAsync(CancellationToken)

Executa a tarefa necessária para limpo recursos usados pelo ServiceBusSender.

CreateMessageBatchAsync(CancellationToken)

Cria um lote de restrição de tamanho ao qual ServiceBusMessage pode ser adicionado usando um TryAddMessage(ServiceBusMessage). Se uma mensagem exceder o tamanho máximo permitido do lote, o lote não permitirá adicionar a mensagem e sinalizará esse cenário usando o valor retornado.

Como as mensagens que violariam a restrição de tamanho não podem ser adicionadas, a publicação de um lote não disparará uma exceção ao tentar enviar as mensagens para a Fila/Tópico.

CreateMessageBatchAsync(CreateMessageBatchOptions, CancellationToken)

Cria um lote de restrição de tamanho ao qual ServiceBusMessage pode ser adicionado usando um padrão baseado em tentativa. Se uma mensagem exceder o tamanho máximo permitido do lote, o lote não permitirá adicionar a mensagem e sinalizará esse cenário usando seu valor retornado.

Como as mensagens que violariam a restrição de tamanho não podem ser adicionadas, a publicação de um lote não disparará uma exceção ao tentar enviar as mensagens para a Fila/Tópico.

DisposeAsync()

Executa a tarefa necessária para limpo recursos usados pelo ServiceBusSender. Isso é equivalente a chamar CloseAsync(CancellationToken).

ScheduleMessageAsync(ServiceBusMessage, DateTimeOffset, CancellationToken)

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

ScheduleMessagesAsync(IEnumerable<ServiceBusMessage>, DateTimeOffset, CancellationToken)

Agenda um conjunto de mensagens a serem exibidas no Barramento de Serviço posteriormente.

SendMessageAsync(ServiceBusMessage, CancellationToken)

Envia uma mensagem para a entidade associada do Barramento de Serviço.

SendMessagesAsync(IEnumerable<ServiceBusMessage>, CancellationToken)

Envia um conjunto de mensagens para a entidade do Barramento de Serviço associada usando uma abordagem em lote. Se o tamanho das mensagens exceder o tamanho máximo de um único lote, uma exceção será disparada e o envio falhará. Para garantir que as mensagens enviadas se encaixem em um lote, use SendMessagesAsync(ServiceBusMessageBatch, CancellationToken) em vez disso.

SendMessagesAsync(ServiceBusMessageBatch, CancellationToken)

Envia um ServiceBusMessageBatch que contém um conjunto de ServiceBusMessage para a entidade associada do Barramento de Serviço.

Aplica-se a