Message.BodyStream Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.