Message.BodyStream Propriedade

Definição

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.

Aplica-se a

Ver também