Message.Extension Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property Extension As Byte()Eigenschaftswert
Ein Bytearray, das anwendungsspezifische, der Meldung zugeordnete Informationen bereitstellt. Der Standardwert ist ein Array der Länge 0.
- Attribute
Ausnahmen
Die Extension-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.
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.
