Freigeben über


EventHubProducerClient.CreateBatchAsync Methode

Definition

Überlädt

CreateBatchAsync(CancellationToken)

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

Da Ereignisse, die gegen die Größeneinschränkung verstoßen, nicht hinzugefügt werden können, wird beim Veröffentlichen eines Batches keine Ausnahme ausgelöst, wenn versucht wird, die Ereignisse an den Event Hubs-Dienst zu senden.

CreateBatchAsync(CreateBatchOptions, CancellationToken)

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

Da Ereignisse, die gegen die Größeneinschränkung verstoßen, nicht hinzugefügt werden können, wird beim Veröffentlichen eines Batches keine Ausnahme ausgelöst, wenn versucht wird, die Ereignisse an den Event Hubs-Dienst zu senden.

CreateBatchAsync(CancellationToken)

Quelle:
EventHubProducerClient.cs
Quelle:
EventHubProducerClient.cs

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

Da Ereignisse, die gegen die Größeneinschränkung verstoßen, nicht hinzugefügt werden können, wird beim Veröffentlichen eines Batches keine Ausnahme ausgelöst, wenn versucht wird, die Ereignisse an den Event Hubs-Dienst zu senden.

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

Parameter

cancellationToken
CancellationToken

Ein optionaler CancellationToken instance, um der Anforderung zu signalisieren, den Vorgang abzubrechen.

Gibt zurück

Ein EventDataBatch mit den Standardbatchoptionen.

Weitere Informationen

Gilt für:

CreateBatchAsync(CreateBatchOptions, CancellationToken)

Quelle:
EventHubProducerClient.cs
Quelle:
EventHubProducerClient.cs

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

Da Ereignisse, die gegen die Größeneinschränkung verstoßen, nicht hinzugefügt werden können, wird beim Veröffentlichen eines Batches keine Ausnahme ausgelöst, wenn versucht wird, die Ereignisse an den Event Hubs-Dienst zu senden.

public virtual System.Threading.Tasks.ValueTask<Azure.Messaging.EventHubs.Producer.EventDataBatch> CreateBatchAsync (Azure.Messaging.EventHubs.Producer.CreateBatchOptions options, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateBatchAsync : Azure.Messaging.EventHubs.Producer.CreateBatchOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.EventHubs.Producer.EventDataBatch>
override this.CreateBatchAsync : Azure.Messaging.EventHubs.Producer.CreateBatchOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.EventHubs.Producer.EventDataBatch>
Public Overridable Function CreateBatchAsync (options As CreateBatchOptions, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EventDataBatch)

Parameter

options
CreateBatchOptions

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

cancellationToken
CancellationToken

Ein optionaler CancellationToken instance, um der Anforderung zu signalisieren, den Vorgang abzubrechen.

Gibt zurück

Ein EventDataBatch mit dem angeforderten options.

Ausnahmen

Tritt auf, wenn sowohl ein Partitionsbezeichner als auch ein Partitionsschlüssel in optionsangegeben wurden.

Weitere Informationen

Gilt für: