Partilhar via


Message.BodyStream Propriedade

Definição

Obtém ou define as informações 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 da propriedade

Um Stream que contém as informações serializadas incluídas no Body da mensagem.

Atributos

Exceções

A fila de mensagens é filtrada para ignorar a propriedade Body.

Comentários

O corpo de uma mensagem pode consistir em qualquer tipo de informação , por exemplo, uma cadeia de caracteres, uma data, uma moeda, um número, uma matriz de bytes ou qualquer objeto gerenciado. Essas informações são serializadas em um Stream a ser passado para a fila.

Especifique a Body propriedade ou a BodyStream propriedade antes de enviar o Message objeto . Se você definir a Body propriedade , o conteúdo será serializado na BodyStream propriedade . No entanto, você pode optar por gravar a BodyStream propriedade diretamente. Isso é útil, por exemplo, quando você deseja abrir uma conexão com um arquivo e transmitir seu conteúdo como o corpo da mensagem.

A menos que você escreva o conteúdo da mensagem diretamente na BodyStream propriedade , defina a Formatter propriedade antes de enviar a mensagem. Quando o Send método é chamado na MessageQueue instância , o corpo é serializado usando o formatador contido na Formatter propriedade . Se você enviar a mensagem sem especificar um valor para a Formatter propriedade , o formatador usará como padrão XmlMessageFormatter.

Se você definir a UseEncryption propriedade true como para o corpo dessa mensagem, a mensagem será criptografada quando for enviada, não quando você definir a Body propriedade. Portanto, a BodyStream propriedade nunca é criptografada.

Aplica-se a

Confira também