Freigeben über


EventHubProducerClient.SendAsync Methode

Definition

Ü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

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 optionsangegeben 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

Gilt für: