Message.Extension Eigenschaft

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Ruft weitere anwendungsspezifische, der Nachricht zugeordnete Informationen ab oder legt diese fest.

public:
 property cli::array <System::Byte> ^ Extension { cli::array <System::Byte> ^ get(); void set(cli::array <System::Byte> ^ value); };

[System.Messaging.MessagingDescription("MsgExtension")]
public byte[] Extension { get; set; }

[<System.Messaging.MessagingDescription("MsgExtension")>]
member this.Extension : byte[] with get, set

Public Property Extension As Byte()

Eigenschaftswert

Byte[]

Ein Bytearray, das anwendungsspezifische, der Meldung zugeordnete Informationen bereitstellt. Der Standardwert ist ein Array der Länge 0.

Attribute

MessagingDescriptionAttribute

Ausnahmen

InvalidOperationException

Die Extension-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.

ArgumentException

Die Extension-Eigenschaft ist null.

Hinweise

Die Extension -Eigenschaft stellt anwendungsdefinierte Informationen bereit, z. B. ein großes binäres Objekt, das der Nachricht zugeordnet ist. Es liegt in der Verantwortung der empfangenden Anwendung, den Inhalt der Extension Eigenschaft zu interpretieren.

Wenn möglich, sollten Sie Nachrichtendaten in die Body -Eigenschaft der Nachricht und nicht in die Extension -Eigenschaft einschließen.

Wenn Sie mit fremden Warteschlangen arbeiten, verwenden Sie die Extension -Eigenschaft, um Nachrichteneigenschaften anzugeben, die in Message Queuing nicht vorhanden sind.

Eine fremde Warteschlange ist in einem anderen Warteschlangensystem als Microsoft Message Queuing vorhanden. Message Queuing kommuniziert mit solchen Warteschlangen über eine Connectoranwendung.

Weitere Informationen

• AppSpecific
• Body