ServiceBusMessageBatch.TryAddMessage(ServiceBusMessage) Methode

Definition

Namespace:

Azure.Messaging.ServiceBus

Assembly:

Azure.Messaging.ServiceBus.dll

Paket:

Azure.Messaging.ServiceBus v7.17.5

Source:

ServiceBusMessageBatch.cs

Versucht, dem Batch eine Nachricht hinzuzufügen, wobei sichergestellt wird, dass die Größe des Batches den Maximalwert nicht überschreitet.

public bool TryAddMessage (Azure.Messaging.ServiceBus.ServiceBusMessage message);

member this.TryAddMessage : Azure.Messaging.ServiceBus.ServiceBusMessage -> bool

Public Function TryAddMessage (message As ServiceBusMessage) As Boolean

Parameter

message

ServiceBusMessage

Die Meldung, die versucht wird, dem Batch hinzuzufügen.

Gibt zurück

Boolean

true , wenn die Nachricht hinzugefügt wurde; falseandernfalls .

Ausnahmen

InvalidOperationException

Wenn ein Batch gesendet wird, wird er für die Dauer dieses Vorgangs gesperrt. Während dieser Zeit dürfen dem Batch keine Nachrichten hinzugefügt werden. Das Aufrufen TryAdd , während der Batch gesendet wird, führt zu einem InvalidOperationException , bis die Übermittlung abgeschlossen ist.

SerializationException

Tritt auf, wenn in der messageApplicationProperties Auflistung ein Member vorhanden ist, der ein nicht unterstützter Typ für die Serialisierung ist. Weitere Informationen finden Sie in den ApplicationProperties Hinweisen.

Hinweise

Wenn eine Nachricht in den Batch akzeptiert wird, werden änderungen, die an den Eigenschaften vorgenommen wurden, nicht im Batch widerzuspiegeln und keine Zustandsübergänge auf den ursprünglichen instance widerzuspiegeln.

Hinweis: Jedes ReadOnlyMemory<T>, Bytearray oder BinaryData instance, das dem Ereignis zugeordnet ist, wird vom Batch referenziert und muss gültig und unverändert bleiben, bis der Batch verworfen wird.