EventDataBatch.TryAdd(EventData) Methode

Definition

Namespace:

Microsoft.ServiceBus.Messaging

Assembly:

Microsoft.ServiceBus.dll

Paket:

WindowsAzure.ServiceBus v6.2.2

Versucht, dem Batch Ereignisdaten hinzuzufügen, sofern dies durch die Größenbeschränkung des Batches zulässig ist.

public bool TryAdd (Microsoft.ServiceBus.Messaging.EventData eventData);

member this.TryAdd : Microsoft.ServiceBus.Messaging.EventData -> bool

Public Function TryAdd (eventData As EventData) As Boolean

Parameter

eventData

EventData

Das hinzuzufügende EventData.

Gibt zurück

Boolean

Ein boolescher Wert, der angibt, ob die Ereignisdaten dem Batch hinzugefügt wurden oder nicht.

Ausnahmen

ArgumentNullException

Wird ausgelöst, wenn EventData NULL ist.

ObjectDisposedException

Wird ausgelöst, wenn der Batch bereits verworfen wurde.

Hinweise

Diese Methode überprüft die Größe des Batches, das EventData-Objekt und den angegebenen Grenzwert, um zu bestimmen, ob das EventData-Objekt hinzugefügt werden kann. Es werden keine anderen Überprüfungen für den aktuellen Batch und das EventData-Objekt ausgeführt. Es ist möglich, dass die Anwendung Ausnahmen vom Sendeaufruf erhält, wenn die in Batch umgewandelten EventData-Objekte nicht in einem Batch gesendet werden können. Sie enthalten beispielsweise unterschiedliche PartitionKey Werte. Für eine unbekannte Puffergröße (angegeben durch -1 für MaxSize während des Aufbaus) erfolgt eine spezielle Handhabung: 1. Kleine Nachrichten werden bis zu einem Grenzwert von 256.000 hinzugefügt, der sowohl für Event Hub-Namespacetypen "Basic" als auch "Standard" funktioniert. 2. Wenn die erste Nachricht > 256.000 ist, ist sie bis zu einer maximalen Größe von 4 MB zulässig, ohne dass weitere Nachrichten zulässig sind. SendBatch schlägt fehl, wenn der EventHub-Namespace diese Größe nicht unterstützt.