EventDataBatch.TryAdd(EventData) Méthode

Définition

Espace de noms:

Microsoft.ServiceBus.Messaging

Assembly:

Microsoft.ServiceBus.dll

Paquet:

WindowsAzure.ServiceBus v6.2.2

Tente d’ajouter des données d’événement au lot si la limite de taille du lot l’autorise.

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

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

Public Function TryAdd (eventData As EventData) As Boolean

Paramètres

eventData

EventData

EventData à ajouter.

Retours

Boolean

Valeur booléenne indiquant si les données d’événement ont été ajoutées au lot ou non.

Exceptions

ArgumentNullException

Levée lorsque eventData a la valeur Null.

ObjectDisposedException

Levée lorsque le lot est déjà supprimé.

Remarques

Cette méthode vérifie les tailles du lot, de l’objet EventData et de la limite spécifiée pour déterminer si l’objet EventData peut être ajouté. Il n’effectue pas d’autres validations sur le lot actuel et l’objet EventData. Il est possible que l’application obtienne des exceptions de l’appel d’envoi si les objets EventData par lot ne peuvent pas être envoyés dans un lot. Par exemple, ils contiennent des valeurs différentes PartitionKey . Pour une taille de mémoire tampon inconnue (indiquée par un -1 pour MaxSize pendant la construction), une gestion spéciale est effectuée : 1. Les petits messages sont ajoutés jusqu’à une limite de 256 000, ce qui fonctionne pour les types d’espace de noms Event Hub « De base » et « Standard ». 2. Si le premier message est > de 256 000, il est autorisé jusqu’à une taille maximale de 4 Mo, sans autres messages autorisés. L’objet SendBatch échoue si l’espace de noms EventHub ne prend pas en charge cette taille.