EventHubProducerClient.CreateBatchAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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
- CreateBatchAsync(CreateBatchOptions, CancellationToken)
- SendAsync(EventDataBatch, CancellationToken)
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:
Azure SDK for .NET