Message.BodyStream Свойство

Определение

Получает или задает сведения в тексте сообщения.Gets or sets the information in the body of the message.

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; }
member this.BodyStream : System.IO.Stream with get, set
Public Property BodyStream As Stream

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

Объект Stream, содержащий сериализованные сведения, включенные в объект Body сообщения.A Stream that contains the serialized information included in the Body of the message.

Атрибуты

Исключения

Очередь сообщений фильтруется, чтобы не учитывать свойство Body.The message queue is filtered to ignore the Body property.

Комментарии

Текст сообщения может состоять из любого типа данных, например строки, даты, валюты, числа, массива байтов или любого управляемого объекта.The body of a message can consist of any type of information - for example, a string, a date, a currency, a number, an array of bytes, or any managed object. Эти сведения сериализуются в объект Stream для передачи в очередь.This information is serialized into a Stream to be passed to the queue.

Перед отправкой Body Message объекта укажите BodyStream либо свойство, либо свойство.Specify either the Body property or the BodyStream property before sending the Message object. Если задать Body свойство, содержимое будет сериализовано BodyStream в свойство.If you set the Body property, the contents are serialized into the BodyStream property. Однако вы можете написать BodyStream свойство напрямую.However, you can choose to write the BodyStream property directly. Это полезно, например, когда нужно открыть подключение к файлу и передать его содержимое в виде текста сообщения.This is useful, for example, when you want to open a connection to a file and stream its contents as the body of your message.

Если содержимое сообщения не записывается непосредственно в BodyStream свойство, Formatter задайте свойство перед отправкой сообщения.Unless you write the contents of the message directly to the BodyStream property, set the Formatter property before you send the message. При вызове MessageQueueметодадля экземпляра тело сериализуется с помощью модуля форматирования, содержащегося в Formatter свойстве. SendWhen the Send method is called on the MessageQueue instance, the body is serialized using the formatter contained in the Formatter property. Если сообщение отправляется без указания значения для Formatter свойства, форматер по умолчанию принимает XmlMessageFormatterзначение.If you send the message without specifying a value for the Formatter property, the formatter defaults to XmlMessageFormatter.

Если задать UseEncryption для true свойства значение для текста сообщения, сообщение будет зашифровано при его отправке, а Body не при задании свойства.If you set the UseEncryption property to true for the body of this message, the message will be encrypted when it is sent, not when you set the Body property. BodyStream Поэтому свойство не шифруется.Therefore, the BodyStream property is never encrypted.

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

Дополнительно