Message.BodyStream Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta le informazioni presenti nel corpo del messaggio.
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 StreamValore della proprietà
Oggetto Stream che contiene le informazioni serializzate contenute nel Body del messaggio.
- Attributi
Eccezioni
La coda di messaggi viene filtrata in modo che venga ignorata la proprietà Body.
Commenti
Il corpo di un messaggio può essere costituito da qualsiasi tipo di informazioni, ad esempio una stringa, una data, una valuta, un numero, una matrice di byte o qualsiasi oggetto gestito. Queste informazioni vengono serializzate in un Stream oggetto da passare alla coda.
Specificare la proprietà o la BodyBodyStream proprietà prima di inviare l'oggetto Message . Se si imposta la Body proprietà, il contenuto viene serializzato nella BodyStream proprietà. Tuttavia, è possibile scegliere di scrivere direttamente la BodyStream proprietà. Questo è utile, ad esempio, quando si vuole aprire una connessione a un file e trasmettere il relativo contenuto come corpo del messaggio.
A meno che non si scrive il contenuto del messaggio direttamente nella BodyStream proprietà, impostare la Formatter proprietà prima di inviare il messaggio. Quando il Send metodo viene chiamato nell'istanza MessageQueue , il corpo viene serializzato usando il formattatore contenuto nella Formatter proprietà. Se si invia il messaggio senza specificare un valore per la Formatter proprietà, il formattatore viene predefinito su XmlMessageFormatter.
Se si imposta la UseEncryption proprietà su true per il corpo di questo messaggio, il messaggio verrà crittografato quando viene inviato, non quando si imposta la Body proprietà. Pertanto, la BodyStream proprietà non viene mai crittografata.
