Partager via


ServiceBusSender Classe

Définition

Client responsable de l’envoi ServiceBusMessage à une entité Service Bus spécifique (file d’attente ou rubrique). Il peut être utilisé pour les entités de session et non-session. Il est construit en appelant CreateSender(String).

public class ServiceBusSender : IAsyncDisposable
type ServiceBusSender = class
    interface IAsyncDisposable
Public Class ServiceBusSender
Implements IAsyncDisposable
Héritage
ServiceBusSender
Implémente

Remarques

Le ServiceBusSender est sûr à mettre en cache et à utiliser pendant la durée de vie d’une application ou jusqu’à ce que le ServiceBusClient par lequel il a été créé soit supprimé. La mise en cache de l’expéditeur est recommandée lorsque l’application publie des messages régulièrement ou semi-régulièrement. L’expéditeur est chargé de garantir une utilisation efficace du réseau, du processeur et de la mémoire. L’appel DisposeAsync() sur l’associé ServiceBusClient pendant l’arrêt de l’application garantit que les ressources réseau et autres objets non managés utilisés par l’expéditeur sont correctement nettoyés.

Constructeurs

ServiceBusSender()

Initialise une nouvelle instance de la classe pour la ServiceBusSender simulation.

ServiceBusSender(ServiceBusClient, String)

Initialise une nouvelle instance de la classe pour une ServiceBusSender utilisation avec des types dérivés.

ServiceBusSender(ServiceBusClient, String, ServiceBusSenderOptions)

Initialise une nouvelle instance de la classe pour une ServiceBusSender utilisation avec des types dérivés.

Propriétés

EntityPath

Chemin d’accès de l’entité à laquelle l’expéditeur est connecté, spécifique à l’espace de noms Service Bus qui le contient.

FullyQualifiedNamespace

Espace de noms Service Bus complet auquel le producteur est associé. Cela est susceptible d’être similaire à {yournamespace}.servicebus.windows.net.

Identifier

Obtient l’ID permettant d’identifier ce client. Cela peut être utilisé pour mettre en corrélation les journaux et les exceptions.

IsClosed

Indique si cette ServiceBusSender opération a été fermée ou non.

Méthodes

CancelScheduledMessageAsync(Int64, CancellationToken)

Annule un message qui a été planifié.

CancelScheduledMessagesAsync(IEnumerable<Int64>, CancellationToken)

Annule un ensemble de messages qui ont été planifiés.

CloseAsync(CancellationToken)

Effectue la tâche nécessaire pour propre les ressources utilisées par .ServiceBusSender

CreateMessageBatchAsync(CancellationToken)

Crée un lot de contrainte de taille auquel ServiceBusMessage peut être ajouté à l’aide d’un TryAddMessage(ServiceBusMessage). Si un message dépasse la taille maximale autorisée du lot, le lot n’autorise pas l’ajout du message et signale que le scénario utilise sa valeur de retour.

Étant donné que les messages qui ne respectent pas la contrainte de taille ne peuvent pas être ajoutés, la publication d’un lot ne déclenche pas d’exception lors de la tentative d’envoi des messages à la file d’attente/rubrique.

CreateMessageBatchAsync(CreateMessageBatchOptions, CancellationToken)

Crée un lot de contraintes de taille auquel ServiceBusMessage peut être ajouté à l’aide d’un modèle basé sur l’essai. Si un message dépasse la taille maximale autorisée du lot, le lot n’autorise pas l’ajout du message et signale ce scénario à l’aide de sa valeur de retour.

Étant donné que les messages qui ne respectent pas la contrainte de taille ne peuvent pas être ajoutés, la publication d’un lot ne déclenche pas d’exception lors de la tentative d’envoi des messages à la file d’attente/rubrique.

DisposeAsync()

Effectue la tâche nécessaire pour propre les ressources utilisées par .ServiceBusSender Cela équivaut à appeler CloseAsync(CancellationToken).

ScheduleMessageAsync(ServiceBusMessage, DateTimeOffset, CancellationToken)

Planifie l’affichage d’un message dans Service Bus ultérieurement.

ScheduleMessagesAsync(IEnumerable<ServiceBusMessage>, DateTimeOffset, CancellationToken)

Planifie l’affichage ultérieur d’un ensemble de messages dans Service Bus.

SendMessageAsync(ServiceBusMessage, CancellationToken)

Envoie un message à l’entité associée de Service Bus.

SendMessagesAsync(IEnumerable<ServiceBusMessage>, CancellationToken)

Envoie un ensemble de messages à l’entité Service Bus associée à l’aide d’une approche par lots. Si la taille des messages dépasse la taille maximale d’un lot unique, une exception est déclenchée et l’envoi échoue. Pour vous assurer que les messages envoyés seront ajustés dans un lot, utilisez SendMessagesAsync(ServiceBusMessageBatch, CancellationToken) à la place.

SendMessagesAsync(ServiceBusMessageBatch, CancellationToken)

Envoie un ServiceBusMessageBatch contenant un ensemble de ServiceBusMessage à l’entité Service Bus associée.

S’applique à