Message.BodyStream Eigenschaft

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Ruft die Daten im Meldungstext ab oder legt diese fest.

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

[System.Messaging.MessagingDescription("MsgBodyStream")]
public System.IO.Stream BodyStream { get; set; }

[<System.Messaging.MessagingDescription("MsgBodyStream")>]
member this.BodyStream : System.IO.Stream with get, set

Public Property BodyStream As Stream

Eigenschaftswert

Stream

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

Attribute

MessagingDescriptionAttribute

Ausnahmen

InvalidOperationException

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

Hinweise

Der Text einer Nachricht kann aus einem beliebigen Informationstyp bestehen, z. B. aus einer Zeichenfolge, einem Datum, einer Währung, einer Zahl, einem Array von Bytes oder einem beliebigen verwalteten Objekt. Diese Informationen werden in ein Stream serialisiert, um an die Warteschlange übergeben zu werden.

Geben Sie entweder die Body -Eigenschaft oder die -Eigenschaft an, BodyStream bevor Sie das Message Objekt senden. Wenn Sie die Body -Eigenschaft festlegen, werden die Inhalte in die BodyStream -Eigenschaft serialisiert. Sie können die Eigenschaft jedoch direkt schreiben BodyStream . Dies ist z. B. nützlich, wenn Sie eine Verbindung mit einer Datei öffnen und deren Inhalt als Nachrichtentext streamen möchten.

Wenn Sie den Inhalt der Nachricht nicht direkt in die BodyStream -Eigenschaft schreiben, legen Sie die Formatter -Eigenschaft fest, bevor Sie die Nachricht senden. Wenn die Send -Methode auf dem MessageQueue instance aufgerufen wird, wird der Text mithilfe des in der -Eigenschaft enthaltenen Formatierungsprogramms Formatter serialisiert. Wenn Sie die Nachricht senden, ohne einen Wert für die Formatter -Eigenschaft anzugeben, lautet der Formatierer XmlMessageFormatterstandardmäßig .

Wenn Sie die UseEncryption -Eigenschaft true für den Textkörper dieser Nachricht auf festlegen, wird die Nachricht beim Senden verschlüsselt, nicht beim Festlegen der Body Eigenschaft. Daher wird die BodyStream Eigenschaft nie verschlüsselt.

Weitere Informationen

• Message
• Body
• BodyType
• Formatter
• AppSpecific
• Extension
• UseEncryption
• Send(Object)