Message.BodyStream 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 die Informationen im Textkörper der Nachricht ab oder legt sie 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, setPublic Property BodyStream As StreamEigenschaftswert
Eine Stream , die die serialisierten Informationen enthält, die in der Body Nachricht enthalten sind.
- Attribute
Ausnahmen
Die Nachrichtenwarteschlange wird gefiltert, um die Body Eigenschaft zu ignorieren.
Hinweise
Der Textkörper einer Nachricht kann aus einem beliebigen Informationstyp bestehen, z. B. einer Zeichenfolge, einem Datum, einer Währung, einer Zahl, einem Bytearray oder einem beliebigen verwalteten Objekt. Diese Informationen werden in eine Stream an die Warteschlange übergebene Daten serialisiert.
Geben Sie die Body Eigenschaft oder die BodyStream Eigenschaft vor dem Senden des Message Objekts an. Wenn Sie die Body Eigenschaft festlegen, werden die Inhalte in die BodyStream Eigenschaft serialisiert. Sie können die BodyStream Eigenschaft jedoch direkt schreiben. Dies ist beispielsweise hilfreich, wenn Sie eine Verbindung mit einer Datei öffnen und deren Inhalt als Textkörper Ihrer Nachricht 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 für die MessageQueue Instanz aufgerufen wird, wird der Textkörper mithilfe des in der Formatter Eigenschaft enthaltenen Formatierers serialisiert. Wenn Sie die Nachricht senden, ohne einen Wert für die Formatter Eigenschaft anzugeben, wird der Formatierer standardmäßig auf XmlMessageFormatter.
Wenn Sie die UseEncryption Eigenschaft true für den Textkörper dieser Nachricht festlegen, wird die Nachricht verschlüsselt, wenn sie gesendet wird, nicht, wenn Sie die Body Eigenschaft festlegen. Daher wird die BodyStream Eigenschaft nie verschlüsselt.
