Message.BodyStream 屬性

定義

命名空間:

System.Messaging

組件:

System.Messaging.dll

取得或設定訊息主體中的資訊。

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

Stream，含有包含於訊息 Body 中的序列化資訊。

屬性

MessagingDescriptionAttribute

例外狀況

InvalidOperationException

篩選訊息佇列以忽略 Body 屬性。

備註

訊息的本文可以包含任何類型的資訊，例如字串、日期、貨幣、數位、位元組數位或任何 Managed 物件。 這項資訊會串行化為 Stream 要傳遞至佇列的 。

在傳送Message物件之前，Body請先指定 屬性或 BodyStream 屬性。 如果您設定 Body 屬性，內容會串行化為 BodyStream 屬性。 不過，您可以選擇直接寫入 BodyStream 屬性。 例如，當您想要開啟檔案的連線，並將其內容串流處理為訊息本文時，這會很有用。

除非您將訊息的內容直接 BodyStream 寫入 屬性，否則請先 Formatter 設定 屬性，再傳送訊息。 Send在實例上MessageQueue呼叫 方法時，主體會使用 屬性中包含的Formatter格式子串行化。 如果您傳送訊息而不指定 屬性的值 Formatter ，格式子預設為 XmlMessageFormatter。

如果您將此 UseEncryption 訊息本文的 屬性 true 設定為 ，則訊息會在傳送時加密，而不是當您設定 Body 屬性時加密。 因此， BodyStream 屬性永遠不會加密。

另請參閱

• Message
• Body
• BodyType
• Formatter
• AppSpecific
• Extension
• UseEncryption
• Send(Object)