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 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, setPublic Property BodyStream As StreamEigenschaftswert
Ein Stream, der die serialisierten Daten aus dem Body der Meldung enthält.
- Attribute
Ausnahmen
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.
