Message.BodyStream Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de informatie in de hoofdtekst van het bericht opgehaald of ingesteld.
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
Waarde van eigenschap
Een Stream die de geserialiseerde informatie bevat die is opgenomen in het Body bericht.
- Kenmerken
Uitzonderingen
De berichtenwachtrij wordt gefilterd om de Body eigenschap te negeren.
Opmerkingen
De hoofdtekst van een bericht kan bestaan uit elk type informatie, bijvoorbeeld een tekenreeks, een datum, een valuta, een getal, een matrix van bytes of een beheerd object. Deze informatie wordt geserialiseerd in een Stream die moet worden doorgegeven aan de wachtrij.
Geef de Body eigenschap of de BodyStream eigenschap op voordat u het Message object verzendt. Als u de Body eigenschap instelt, wordt de inhoud geserialiseerd in de BodyStream eigenschap. U kunt er echter voor kiezen om de BodyStream eigenschap rechtstreeks te schrijven. Dit is bijvoorbeeld handig als u een verbinding met een bestand wilt openen en de inhoud ervan wilt streamen als de hoofdtekst van uw bericht.
Tenzij u de inhoud van het bericht rechtstreeks naar de BodyStream eigenschap schrijft, stelt u de Formatter eigenschap in voordat u het bericht verzendt. Wanneer de Send methode wordt aangeroepen op het MessageQueue exemplaar, wordt de hoofdtekst geserialiseerd met behulp van de formatter in de Formatter eigenschap. Als u het bericht verzendt zonder een waarde voor de Formatter eigenschap op te geven, wordt de notatie standaard ingesteld op XmlMessageFormatter.
Als u de UseEncryption eigenschap true instelt voor de hoofdtekst van dit bericht, wordt het bericht versleuteld wanneer het wordt verzonden, niet wanneer u de Body eigenschap instelt. Daarom wordt de BodyStream eigenschap nooit versleuteld.