Condividi tramite


Message.BodyStream Proprietà

Definizione

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, set
Public Property BodyStream As Stream

Valore 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.

Si applica a

Vedi anche