Freigeben über


ServiceBusSender Klasse

Definition

Ein Client, der für das Senden ServiceBusMessage an eine bestimmte Service Bus-Entität (Warteschlange oder Thema) verantwortlich ist. Sie kann sowohl für Sitzungs- als auch für Nichtsitzungsentitäten verwendet werden. Sie wird durch Aufrufen CreateSender(String)von erstellt.

public class ServiceBusSender : IAsyncDisposable
type ServiceBusSender = class
    interface IAsyncDisposable
Public Class ServiceBusSender
Implements IAsyncDisposable
Vererbung
ServiceBusSender
Implementiert

Hinweise

Kann ServiceBusSender sicher zwischengespeichert und verwendet werden, während der Lebensdauer einer Anwendung oder bis die, von der ServiceBusClient sie erstellt wurde, verworfen wird. Das Zwischenspeichern des Absenders wird empfohlen, wenn die Anwendung regelmäßig oder halb regelmäßig Nachrichten veröffentlicht. Der Absender ist dafür verantwortlich, eine effiziente Netzwerk-, CPU- und Arbeitsspeichernutzung sicherzustellen. Durch das Aufrufen DisposeAsync() des zugeordneten ServiceBusClient beim Herunterfahren der Anwendung wird sichergestellt, dass Netzwerkressourcen und andere nicht verwaltete Objekte, die vom Absender verwendet werden, ordnungsgemäß bereinigt werden.

Konstruktoren

ServiceBusSender()

Initialisiert eine neue instance der -Klasse für die ServiceBusSender Simulation.

ServiceBusSender(ServiceBusClient, String)

Initialisiert einen neuen instance der ServiceBusSender -Klasse zur Verwendung mit abgeleiteten Typen.

ServiceBusSender(ServiceBusClient, String, ServiceBusSenderOptions)

Initialisiert einen neuen instance der ServiceBusSender -Klasse zur Verwendung mit abgeleiteten Typen.

Eigenschaften

EntityPath

Der Pfad der Entität, mit der der Absender verbunden ist, spezifisch für den Service Bus-Namespace, der ihn enthält.

FullyQualifiedNamespace

Der vollqualifizierte Service Bus-Namespace, dem der Producer zugeordnet ist. Dies ist wahrscheinlich ähnlich wie .{yournamespace}.servicebus.windows.net

Identifier

Ruft die ID ab, um diesen Client zu identifizieren. Dies kann verwendet werden, um Protokolle und Ausnahmen zu korrelieren.

IsClosed

Gibt an, ob diese ServiceBusSender geschlossen wurde.

Methoden

CancelScheduledMessageAsync(Int64, CancellationToken)

Bricht eine geplante Nachricht ab.

CancelScheduledMessagesAsync(IEnumerable<Int64>, CancellationToken)

Bricht eine Reihe von Nachrichten ab, die geplant wurden.

CloseAsync(CancellationToken)

Führt die Aufgabe aus, die zum sauber von ServiceBusSenderverwendeten Ressourcen erforderlich ist.

CreateMessageBatchAsync(CancellationToken)

Erstellt einen Batch mit Größeneinschränkung, dem ServiceBusMessage mithilfe eines TryAddMessage(ServiceBusMessage)hinzugefügt werden kann. Wenn eine Nachricht die maximal zulässige Größe des Batches überschreiten würde, lässt der Batch das Hinzufügen der Nachricht nicht zu und signalisiert dieses Szenario mit dem Rückgabewert.

Da Nachrichten, die die Größeneinschränkung verletzen, nicht hinzugefügt werden können, wird beim Veröffentlichen eines Batches keine Ausnahme ausgelöst, wenn versucht wird, die Nachrichten an die Warteschlange/das Thema zu senden.

CreateMessageBatchAsync(CreateMessageBatchOptions, CancellationToken)

Erstellt einen Batch mit Größeneinschränkung, dem ServiceBusMessage mithilfe eines try-basierten Musters hinzugefügt werden kann. Wenn eine Nachricht die maximal zulässige Größe des Batches überschreiten würde, lässt der Batch das Hinzufügen der Nachricht nicht zu und signalisiert dieses Szenario mit dem Rückgabewert.

Da Nachrichten, die die Größeneinschränkung verletzen, nicht hinzugefügt werden können, wird beim Veröffentlichen eines Batches keine Ausnahme ausgelöst, wenn versucht wird, die Nachrichten an die Warteschlange/das Thema zu senden.

DisposeAsync()

Führt die Aufgabe aus, die zum sauber von ServiceBusSenderverwendeten Ressourcen erforderlich ist. Dies entspricht dem Aufrufen von CloseAsync(CancellationToken).

ScheduleMessageAsync(ServiceBusMessage, DateTimeOffset, CancellationToken)

Plant, dass eine Nachricht zu einem späteren Zeitpunkt in Service Bus angezeigt wird.

ScheduleMessagesAsync(IEnumerable<ServiceBusMessage>, DateTimeOffset, CancellationToken)

Plant eine Reihe von Nachrichten, die zu einem späteren Zeitpunkt in Service Bus angezeigt werden.

SendMessageAsync(ServiceBusMessage, CancellationToken)

Sendet eine Nachricht an die zugeordnete Entität von Service Bus.

SendMessagesAsync(IEnumerable<ServiceBusMessage>, CancellationToken)

Sendet einen Satz von Nachrichten mithilfe eines Batchansatzes an die zugeordnete Service Bus-Entität. Wenn die Größe der Nachrichten die maximale Größe eines einzelnen Batches überschreitet, wird eine Ausnahme ausgelöst, und der Sendevorgang schlägt fehl. Verwenden Sie stattdessen, um sicherzustellen, SendMessagesAsync(ServiceBusMessageBatch, CancellationToken) dass die gesendeten Nachrichten in einen Batch passen.

SendMessagesAsync(ServiceBusMessageBatch, CancellationToken)

Sendet eine ServiceBusMessageBatch , die einen Satz von ServiceBusMessage enthält, an die zugeordnete Service Bus-Entität.

Gilt für: