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 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, set
Public Property BodyStream As Stream
Valore della proprietà
Oggetto Stream contenente le informazioni serializzate incluse nel Body del messaggio.
- Attributi
Eccezioni
La coda di messaggi viene filtrata per ignorare la Body proprietà .
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 Body proprietà o la BodyStream 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à. Ciò è utile, ad esempio, quando si vuole aprire una connessione a un file e trasmetterne il contenuto come corpo del messaggio.
A meno che non si scriva 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 di , il corpo viene serializzato usando il formattatore contenuto nella Formatter proprietà . Se si invia il messaggio senza specificare un valore per la proprietà, per impostazione Formatter predefinita il formattatore è XmlMessageFormatter.
Se si imposta la UseEncryption proprietà su true per il corpo del messaggio, il messaggio verrà crittografato quando viene inviato, non quando si imposta la Body proprietà . Pertanto, la BodyStream proprietà non viene mai crittografata.