EventHubProducerClient.SendAsync 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
SendAsync(EventDataBatch, CancellationToken) |
Sendet eine Reihe von Ereignissen mithilfe eines Batchansatzes an den zugeordneten Event Hub. |
SendAsync(IEnumerable<EventData>, CancellationToken) |
Sendet eine Reihe von Ereignissen als einzelnen Vorgang an den zugeordneten Event Hub. Um den Mehraufwand zu vermeiden, der mit dem Messen und Überprüfen der Größe im Client verbunden ist, wird die Validierung an den Event Hubs-Dienst delegiert und verzögert, bis der Vorgang aufgerufen wird. Der Aufruf schlägt fehl, wenn die Größe des angegebenen Ereignissatzes die maximal zulässige Größe eines einzelnen Batches überschreitet. |
SendAsync(IEnumerable<EventData>, SendEventOptions, CancellationToken) |
Sendet eine Reihe von Ereignissen als einzelnen Vorgang an den zugeordneten Event Hub. Um den Mehraufwand zu vermeiden, der mit dem Messen und Überprüfen der Größe im Client verbunden ist, wird die Validierung an den Event Hubs-Dienst delegiert und verzögert, bis der Vorgang aufgerufen wird. Der Aufruf schlägt fehl, wenn die Größe des angegebenen Ereignissatzes die maximal zulässige Größe eines einzelnen Batches überschreitet. |
SendAsync(EventDataBatch, CancellationToken)
- Quelle:
- EventHubProducerClient.cs
- Quelle:
- EventHubProducerClient.cs
Sendet eine Reihe von Ereignissen mithilfe eines Batchansatzes an den zugeordneten Event Hub.
public virtual System.Threading.Tasks.Task SendAsync (Azure.Messaging.EventHubs.Producer.EventDataBatch eventBatch, System.Threading.CancellationToken cancellationToken = default);
abstract member SendAsync : Azure.Messaging.EventHubs.Producer.EventDataBatch * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.SendAsync : Azure.Messaging.EventHubs.Producer.EventDataBatch * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function SendAsync (eventBatch As EventDataBatch, Optional cancellationToken As CancellationToken = Nothing) As Task
Parameter
- eventBatch
- EventDataBatch
Der Satz der zu sendenden Ereignisdaten. Ein Batch kann mit CreateBatchAsync(CancellationToken)erstellt werden.
- cancellationToken
- CancellationToken
Ein optionaler CancellationToken instance, um der Anforderung zu signalisieren, den Vorgang abzubrechen.
Gibt zurück
Eine Aufgabe, die nach Abschluss des Vorgangs aufgelöst werden soll; wenn keine Ausnahme ausgelöst wird, wenn erwartet wird, hat der Event Hubs-Dienst den Empfang bestätigt und die Verantwortung für die Übermittlung des Batches übernommen.
Ausnahmen
Tritt auf, wenn sowohl ein Partitionsbezeichner als auch ein Partitionsschlüssel vom Batch angegeben wurden.
Hinweise
Nach der Veröffentlichung ist das Ergebnis atomar; Entweder waren alle Ereignisse, die zum Batch gehören, erfolgreich oder alle sind fehlgeschlagen. Ein Teilerfolg ist nicht möglich.
Weitere Informationen
Gilt für:
SendAsync(IEnumerable<EventData>, CancellationToken)
- Quelle:
- EventHubProducerClient.cs
- Quelle:
- EventHubProducerClient.cs
Sendet eine Reihe von Ereignissen als einzelnen Vorgang an den zugeordneten Event Hub. Um den Mehraufwand zu vermeiden, der mit dem Messen und Überprüfen der Größe im Client verbunden ist, wird die Validierung an den Event Hubs-Dienst delegiert und verzögert, bis der Vorgang aufgerufen wird. Der Aufruf schlägt fehl, wenn die Größe des angegebenen Ereignissatzes die maximal zulässige Größe eines einzelnen Batches überschreitet.
public virtual System.Threading.Tasks.Task SendAsync (System.Collections.Generic.IEnumerable<Azure.Messaging.EventHubs.EventData> eventBatch, System.Threading.CancellationToken cancellationToken = default);
abstract member SendAsync : seq<Azure.Messaging.EventHubs.EventData> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.SendAsync : seq<Azure.Messaging.EventHubs.EventData> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function SendAsync (eventBatch As IEnumerable(Of EventData), Optional cancellationToken As CancellationToken = Nothing) As Task
Parameter
- eventBatch
- IEnumerable<EventData>
Der Satz der zu sendenden Ereignisdaten.
- cancellationToken
- CancellationToken
Ein optionaler CancellationToken instance, um der Anforderung zu signalisieren, den Vorgang abzubrechen.
Gibt zurück
Eine Aufgabe, die nach Abschluss des Vorgangs aufgelöst werden soll; Wenn beim Erwarteten keine Ausnahme ausgelöst wird, hat der Event Hubs-Dienst den Empfang bestätigt und die Verantwortung für die Übermittlung der Ereignismenge an seine Partition übernommen.
Ausnahmen
Tritt auf, wenn der Ereignissatz die maximal zulässige Größe in einem einzelnen Batch überschreitet, wie vom Event Hubs-Dienst festgelegt. Wird Reason in diesem Fall auf MessageSizeExceeded festgelegt.
Tritt auf, wenn eines der Ereignisse in der eventBatch
-Auflistung einen Member enthält, der ein nicht unterstützter Typ für die Properties Serialisierung ist. Weitere Informationen finden Sie in den Properties Hinweisen.
Hinweise
Nach der Veröffentlichung ist das Ergebnis atomar; entweder alle Ereignisse, die zum Satz gehören, waren erfolgreich oder alle sind fehlgeschlagen. Ein Teilerfolg ist nicht möglich.
Weitere Informationen
- CreateBatchAsync(CancellationToken)
- SendAsync(IEnumerable<EventData>, SendEventOptions, CancellationToken)
- SendAsync(EventDataBatch, CancellationToken)
Gilt für:
SendAsync(IEnumerable<EventData>, SendEventOptions, CancellationToken)
- Quelle:
- EventHubProducerClient.cs
- Quelle:
- EventHubProducerClient.cs
Sendet eine Reihe von Ereignissen als einzelnen Vorgang an den zugeordneten Event Hub. Um den Mehraufwand zu vermeiden, der mit dem Messen und Überprüfen der Größe im Client verbunden ist, wird die Validierung an den Event Hubs-Dienst delegiert und verzögert, bis der Vorgang aufgerufen wird. Der Aufruf schlägt fehl, wenn die Größe des angegebenen Ereignissatzes die maximal zulässige Größe eines einzelnen Batches überschreitet.
public virtual System.Threading.Tasks.Task SendAsync (System.Collections.Generic.IEnumerable<Azure.Messaging.EventHubs.EventData> eventBatch, Azure.Messaging.EventHubs.Producer.SendEventOptions options, System.Threading.CancellationToken cancellationToken = default);
abstract member SendAsync : seq<Azure.Messaging.EventHubs.EventData> * Azure.Messaging.EventHubs.Producer.SendEventOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.SendAsync : seq<Azure.Messaging.EventHubs.EventData> * Azure.Messaging.EventHubs.Producer.SendEventOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function SendAsync (eventBatch As IEnumerable(Of EventData), options As SendEventOptions, Optional cancellationToken As CancellationToken = Nothing) As Task
Parameter
- eventBatch
- IEnumerable<EventData>
Der Satz der zu sendenden Ereignisdaten.
- options
- SendEventOptions
Der Satz von Optionen, die beim Senden dieses Batches zu berücksichtigen sind.
- cancellationToken
- CancellationToken
Ein optionaler CancellationToken instance, um der Anforderung zu signalisieren, den Vorgang abzubrechen.
Gibt zurück
Eine Aufgabe, die nach Abschluss des Vorgangs aufgelöst werden soll; Wenn beim Erwarteten keine Ausnahme ausgelöst wird, hat der Event Hubs-Dienst den Empfang bestätigt und die Verantwortung für die Übermittlung der Ereignismenge an seine Partition übernommen.
Ausnahmen
Tritt auf, wenn sowohl ein Partitionsbezeichner als auch ein Partitionsschlüssel in options
angegeben wurden.
Tritt auf, wenn der Ereignissatz die maximal zulässige Größe in einem einzelnen Batch überschreitet, wie vom Event Hubs-Dienst festgelegt. Wird Reason in diesem Fall auf MessageSizeExceeded festgelegt.
Tritt auf, wenn eines der Ereignisse in der eventBatch
-Auflistung einen Member enthält, der ein nicht unterstützter Typ für die Properties Serialisierung ist. Weitere Informationen finden Sie in den Properties Hinweisen.
Hinweise
Nach der Veröffentlichung ist das Ergebnis atomar; entweder alle Ereignisse, die zum Satz gehören, waren erfolgreich oder alle sind fehlgeschlagen. Ein Teilerfolg ist nicht möglich.
Weitere Informationen
- CreateBatchAsync(CreateBatchOptions, CancellationToken)
- SendAsync(IEnumerable<EventData>, CancellationToken)
- SendAsync(EventDataBatch, CancellationToken)
Gilt für:
Azure SDK for .NET