Export (0) Print
Expand All

Message.BodyStream Property

Gets or sets the information in the body of the message.

Namespace:  System.Messaging
Assembly:  System.Messaging (in System.Messaging.dll)

[MessagingDescriptionAttribute("MsgBodyStream")]
public Stream BodyStream { get; set; }

Property Value

Type: System.IO.Stream
A Stream that contains the serialized information included in the Body of the message.

ExceptionCondition
InvalidOperationException

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. This information is serialized into a Stream to be passed to the queue.

Specify either the Body property or the BodyStream property before sending the Message object. If you set the Body property, the contents are serialized into the BodyStream property. 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.

Unless you write the contents of the message directly to the BodyStream property, set the Formatter property before you send the message. When the Send method is called on the MessageQueue instance, the body is serialized using the formatter contained in the Formatter property. If you send the message without specifying a value for the Formatter property, the formatter defaults to XmlMessageFormatter.

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. Therefore, the BodyStream property is never encrypted.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft