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 以传递给队列。

Body在发送 Message 对象之前指定 BodyStream 属性或 属性。 如果设置 Body 属性,则内容将序列化为 BodyStream 属性。 但是,可以选择直接写入 BodyStream 属性。 例如,当你想要打开与文件的连接并将其内容作为消息正文进行流式传输时,这非常有用。

除非将消息的内容直接写入 属性, BodyStream 否则请在发送消息之前设置 Formatter 属性。 Send在 实例上MessageQueue调用 方法时,将使用 属性中包含的Formatter格式化程序序列化正文。 如果在未为 Formatter 属性指定值的情况下发送消息,则格式化程序默认为 XmlMessageFormatter

如果将此消息正文的 属性设置为 UseEncryptiontrue ,则消息在发送时将加密,而不是在设置 Body 属性时加密。 因此,该 BodyStream 属性永远不会加密。

适用于

另请参阅