Поделиться через


Message.BodyStream Свойство

Определение

Получает или задает сведения в тексте сообщения.

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

Значение свойства

Объект Stream, содержащий сериализованные сведения, включенные в объект Body сообщения.

Атрибуты

Исключения

Очередь сообщений фильтруется, чтобы не учитывать свойство Body.

Комментарии

Текст сообщения может состоять из информации любого типа, например строки, даты, валюты, числа, массива байтов или любого управляемого объекта. Эти сведения сериализуются в Stream для отправки в очередь.

Перед отправкой BodyMessage объекта укажите свойство или BodyStream свойство . Если задать Body свойство , содержимое сериализуется в BodyStream свойство . Однако вы можете написать BodyStream свойство напрямую. Это полезно, например, если вы хотите открыть подключение к файлу и выполнить потоковую передачу его содержимого в тексте сообщения.

Если вы не записываете содержимое сообщения непосредственно в BodyStream свойство , задайте Formatter свойство перед отправкой сообщения. При вызове Send метода в экземпляре MessageQueue тело сериализуется с помощью модуля форматирования, содержащегося в свойстве Formatter . Если вы отправляете сообщение без указания значения для Formatter свойства, по умолчанию модуль форматирования имеет значение XmlMessageFormatter.

Если для свойства задано UseEncryption значение true для текста этого сообщения, сообщение будет зашифровано при его отправке Body , а не при установке свойства . Таким образом BodyStream , свойство никогда не шифруется.

Применяется к

См. также раздел