Message.BodyStream Propiedad

Definición

Obtiene o establece la información del cuerpo del mensaje.

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

Valor de propiedad

Stream que contiene la información serializada incluida en el cuerpo (Body) del mensaje.

Atributos

Excepciones

La cola de mensajes se filtra para omitir la propiedad Body.

Comentarios

El cuerpo de un mensaje puede constar de cualquier tipo de información( por ejemplo, una cadena, una fecha, una moneda, un número, una matriz de bytes o cualquier objeto administrado. Esta información se serializa en un objeto Stream que se va a pasar a la cola.

Especifique la Body propiedad o la BodyStream propiedad antes de enviar el Message objeto. Si establece la Body propiedad , el contenido se serializa en la BodyStream propiedad . Sin embargo, puede elegir escribir la BodyStream propiedad directamente. Esto resulta útil, por ejemplo, cuando desea abrir una conexión a un archivo y transmitir su contenido como el cuerpo del mensaje.

A menos que escriba el contenido del mensaje directamente en la BodyStream propiedad , establezca la Formatter propiedad antes de enviar el mensaje. Cuando se llama al Send método en la MessageQueue instancia de , el cuerpo se serializa mediante el formateador contenido en la Formatter propiedad . Si envía el mensaje sin especificar un valor para la Formatter propiedad , el formateador tiene como valor predeterminado XmlMessageFormatter.

Si establece la UseEncryption propiedad true en para el cuerpo de este mensaje, el mensaje se cifrará cuando se envíe, no cuando establezca la Body propiedad . Por lo tanto, la BodyStream propiedad nunca se cifra.

Se aplica a

Consulte también