Message.BodyStream Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou coloca a informação no corpo da mensagem.
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 Propriedade
A Stream que contém a informação serializada incluída Body na mensagem.
- Atributos
Exceções
A fila de mensagens é filtrada para ignorar a Body propriedade.
Observações
O corpo de uma mensagem pode consistir em qualquer tipo de informação – por exemplo, uma cadeia, uma data, uma moeda, um número, um array de bytes ou qualquer objeto gerido. Esta informação é serializada para Stream ser passada à fila.
Especifique a Body propriedade ou a BodyStream propriedade antes de enviar o Message objeto. Se definir a Body propriedade, o conteúdo é serializado na BodyStream propriedade. No entanto, pode optar por registar a BodyStream propriedade diretamente. Isto é útil, por exemplo, quando quer abrir uma ligação a um ficheiro e transmitir o seu conteúdo como o corpo da sua mensagem.
A menos que escrevas o conteúdo da mensagem diretamente na BodyStream propriedade, define a Formatter propriedade antes de enviares a mensagem. Quando o Send método é chamado na MessageQueue instância, o corpo é serializado usando o formatador contido na Formatter propriedade. Se enviar a mensagem sem especificar um valor para a Formatter propriedade, o formatador passa por defeito a XmlMessageFormatter.
Se definires a UseEncryption propriedade para true o corpo desta mensagem, a mensagem será encriptada quando for enviada, não quando definires a Body propriedade. Portanto, a BodyStream propriedade nunca é encriptada.