ServiceBusSender.CreateMessageBatchAsync Methode

  • Referenz

Definition

Namespace:
Azure.Messaging.ServiceBus
Assembly:
Azure.Messaging.ServiceBus.dll
Paket:
Azure.Messaging.ServiceBus v7.17.5

Überlädt

CreateMessageBatchAsync(CancellationToken)

Erstellt einen Batch zur Größeneinschränkung, dem ServiceBusMessage mithilfe von TryAddMessage(ServiceBusMessage)hinzugefügt werden kann. Wenn eine Nachricht die maximal zulässige Größe des Batches überschreitet, lässt der Batch das Hinzufügen der Nachricht nicht zu und signalisiert, dass das Szenario, in dem sie verwendet wird, den Wert zurückgibt.

Da Nachrichten, die gegen die Größeneinschränkung verstoßen, nicht hinzugefügt werden können, löst die Veröffentlichung eines Batches keine Ausnahme aus, wenn versucht wird, die Nachrichten an die Warteschlange/das Thema zu senden.
CreateMessageBatchAsync(CreateMessageBatchOptions, CancellationToken)

Erstellt einen Batch zur Größeneinschränkung, dem ServiceBusMessage mithilfe eines testbasierten Musters hinzugefügt werden kann. Wenn eine Nachricht die maximal zulässige Größe des Batches überschreitet, lässt der Batch das Hinzufügen der Nachricht nicht zu und signalisiert dieses Szenario mithilfe des Rückgabewerts.

Da Nachrichten, die gegen die Größeneinschränkung verstoßen, nicht hinzugefügt werden können, löst die Veröffentlichung eines Batches keine Ausnahme aus, wenn versucht wird, die Nachrichten an die Warteschlange/das Thema zu senden.

CreateMessageBatchAsync(CancellationToken)

Source:
ServiceBusSender.cs

Erstellt einen Batch zur Größeneinschränkung, dem ServiceBusMessage mithilfe von TryAddMessage(ServiceBusMessage)hinzugefügt werden kann. Wenn eine Nachricht die maximal zulässige Größe des Batches überschreitet, lässt der Batch das Hinzufügen der Nachricht nicht zu und signalisiert, dass das Szenario, in dem sie verwendet wird, den Wert zurückgibt.

Da Nachrichten, die gegen die Größeneinschränkung verstoßen, nicht hinzugefügt werden können, löst die Veröffentlichung eines Batches keine Ausnahme aus, wenn versucht wird, die Nachrichten an die Warteschlange/das Thema zu senden.

public virtual System.Threading.Tasks.ValueTask<Azure.Messaging.ServiceBus.ServiceBusMessageBatch> CreateMessageBatchAsync (System.Threading.CancellationToken cancellationToken = default);
abstract member CreateMessageBatchAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.ServiceBus.ServiceBusMessageBatch>
override this.CreateMessageBatchAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.ServiceBus.ServiceBusMessageBatch>
Public Overridable Function CreateMessageBatchAsync (Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of ServiceBusMessageBatch)

Parameter

cancellationToken
CancellationToken

Ein optionaler CancellationToken instance, um die Anforderung zum Abbrechen des Vorgangs zu signalisieren.

Gibt zurück

ValueTask<ServiceBusMessageBatch>

Ein ServiceBusMessageBatch mit den Standardbatchoptionen.

Weitere Informationen

Gilt für:

CreateMessageBatchAsync(CreateMessageBatchOptions, CancellationToken)

Source:
ServiceBusSender.cs

Erstellt einen Batch zur Größeneinschränkung, dem ServiceBusMessage mithilfe eines testbasierten Musters hinzugefügt werden kann. Wenn eine Nachricht die maximal zulässige Größe des Batches überschreitet, lässt der Batch das Hinzufügen der Nachricht nicht zu und signalisiert dieses Szenario mithilfe des Rückgabewerts.

Da Nachrichten, die gegen die Größeneinschränkung verstoßen, nicht hinzugefügt werden können, löst die Veröffentlichung eines Batches keine Ausnahme aus, wenn versucht wird, die Nachrichten an die Warteschlange/das Thema zu senden.

public virtual System.Threading.Tasks.ValueTask<Azure.Messaging.ServiceBus.ServiceBusMessageBatch> CreateMessageBatchAsync (Azure.Messaging.ServiceBus.CreateMessageBatchOptions options, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateMessageBatchAsync : Azure.Messaging.ServiceBus.CreateMessageBatchOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.ServiceBus.ServiceBusMessageBatch>
override this.CreateMessageBatchAsync : Azure.Messaging.ServiceBus.CreateMessageBatchOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.ServiceBus.ServiceBusMessageBatch>
Public Overridable Function CreateMessageBatchAsync (options As CreateMessageBatchOptions, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of ServiceBusMessageBatch)

Parameter

options
CreateMessageBatchOptions

Der Satz von Optionen, die beim Erstellen dieses Batches zu berücksichtigen sind.

cancellationToken
CancellationToken

Ein optionaler CancellationToken instance, um die Anforderung zum Abbrechen des Vorgangs zu signalisieren.

Gibt zurück

ValueTask<ServiceBusMessageBatch>

Ein ServiceBusMessageBatch mit dem angeforderten options.

Weitere Informationen

Gilt für: