Message.BodyStream-Eigenschaft

Artikel
08/20/2007

Ruft die Daten im Meldungstext ab oder legt diese fest.

Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)

Syntax

'Declaration
Public Property BodyStream As Stream
'Usage
Dim instance As Message
Dim value As Stream

value = instance.BodyStream

instance.BodyStream = value

public Stream BodyStream { get; set; }

public:
property Stream^ BodyStream {
    Stream^ get ();
    void set (Stream^ value);
}

/** @property */
public Stream get_BodyStream ()

/** @property */
public void set_BodyStream (Stream value)

public function get BodyStream () : Stream

public function set BodyStream (value : Stream)

Eigenschaftenwert

Ein Stream, der die serialisierten Daten aus dem Body der Meldung enthält.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Die Body-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.

Hinweise

Der Meldungstext kann beliebige Datentypen enthalten, beispielsweise eine Zeichenfolge, ein Datum, eine Währung, eine Zahl, ein Bytearray oder ein beliebiges verwaltetes Objekt. Die Daten werden für die Weitergabe an die Warteschlange in einen Stream serialisiert.

Geben Sie vor dem Senden des Message-Objekts entweder die Body-Eigenschaft oder die BodyStream-Eigenschaft an. Wenn Sie die Body-Eigenschaft festlegen, wird deren Inhalt in die BodyStream-Eigenschaft serialisiert. Sie können jedoch auch direkt in die BodyStream-Eigenschaft schreiben. Dies ist beispielsweise nützlich, wenn Sie eine Verbindung zu einer Datei öffnen und den Inhalt als Stream im Nachrichtenkörper übertragen möchten.

Wenn Sie den Inhalt der Meldung nicht direkt in die BodyStream-Eigenschaft schreiben, müssen Sie vor dem Senden die Formatter-Eigenschaft festlegen. Bei einem Aufruf der Send-Methode für die MessageQueue-Instanz wird der Meldungstext anhand des in der Formatter-Eigenschaft enthaltenen Formatierers serialisiert. Wenn Sie die Meldung ohne Angabe eines Werts für die Formatter-Eigenschaft senden, wird der Standardformatierer XmlMessageFormatter verwendet.

Wenn Sie die UseEncryption-Eigenschaft für den Meldungstext auf true festlegen, wird die Meldung beim Senden verschlüsselt. Dies erfolgt nicht durch Festlegen der Body-Eigenschaft. Die BodyStream-Eigenschaft wird daher niemals verschlüsselt.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

Message-Klasse
Message-Member
System.Messaging-Namespace
Message-Klasse
Message.Body-Eigenschaft
BodyType
Formatter
Message.AppSpecific-Eigenschaft
Extension
UseEncryption
Send

Share via