Message.BodyStream プロパティ

.NET Framework クラス ライブラリ リファレンス

Message.BodyStream プロパティ

メッセージの本文の情報を取得または設定します。

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Property BodyStream As
 Stream

Visual Basic (使用法)

Dim instance As Message
Dim value As Stream

value = instance.BodyStream

instance.BodyStream = value

C#

public Stream BodyStream { get; set;
 }

C++

public:
property Stream^ BodyStream {
    Stream^ get ();
    void set (Stream^ value);
}

J#

/** @property */
public Stream get_BodyStream ()

/** @property */
public void set_BodyStream (Stream value)

JScript

public function get BodyStream
 () : Stream

public function set BodyStream
 (value : Stream)

プロパティ値
メッセージの Body に含まれるシリアル化された情報を格納する Stream。

例外

例外の種類	条件
InvalidOperationException	フィルタ処理されたメッセージ キューが、Body プロパティを無視します。

解説

メッセージの本文は、文字列、日付、通貨、数値、バイト配列、マネージ オブジェクトなど、任意の型の情報で構成できます。この情報は、Stream にシリアル化されてキューに渡されます。

Message オブジェクトを送信する前に、Body プロパティまたは BodyStream プロパティのいずれかを指定します。Body プロパティを設定すると、内容は BodyStream プロパティにシリアル化されます。ただし、BodyStream プロパティに直接書き込むこともできます。直接書き込む方法は、たとえば、ファイルへの接続を開いて、ファイルの内容をメッセージの本文としてストリーム転送する場合に便利です。

メッセージの内容を BodyStream プロパティに直接書き込む以外は、メッセージを送信する前に Formatter プロパティを設定します。MessageQueue インスタンスで Send メソッドが呼び出された場合は、Formatter プロパティに格納されている書式指定子を使用して、メッセージの本文がシリアル化されます。Formatter プロパティの値を指定せずにメッセージを送信した場合、書式指定子は既定値の XmlMessageFormatter に設定されます。

そのメッセージの本文について UseEncryption プロパティを true に設定すると、Body プロパティを設定するときではなく、メッセージが送信されるときに暗号化されます。このため BodyStream プロパティが暗号化されることはありません。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Message クラス
Message メンバ
System.Messaging 名前空間
Message クラス
Message.Body プロパティ
BodyType
Formatter
Message.AppSpecific プロパティ
Extension
UseEncryption
Send