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 zusätzliche, anwendungsdefinierte Informationen ab, die der Nachricht zugeordnet sind, 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 Array von Bytewerten, das anwendungsdefinierte Informationen bereitstellt, die der Nachricht zugeordnet sind. Der Standardwert ist ein Array der Länge Null.
- Attribute
Ausnahmen
Die Nachrichtenwarteschlange wird gefiltert, um die Extension Eigenschaft zu ignorieren.
Die Extension Eigenschaft ist null.
Hinweise
Die Extension Eigenschaft stellt anwendungsdefinierte Informationen bereit, z. B. ein großes binärobjekt, 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 anstelle der Extension Eigenschaft einschließen.
Verwenden Sie beim Arbeiten mit fremden Warteschlangen 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.
