BinaryMessageFormatter.Write メソッド

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

BinaryMessageFormatter.Write メソッド

オブジェクトをメッセージの本文にシリアル化します。

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

Visual Basic (宣言)

Public Sub Write ( _
    message As Message, _
    obj As Object _
)

Visual Basic (使用法)

Dim instance As BinaryMessageFormatter
Dim message As Message
Dim obj As Object

instance.Write(message, obj)

C#

public void Write (
    Message message,
    Object obj
)

C++

public:
virtual void Write (
    Message^ message, 
    Object^ obj
) sealed

J#

public final void Write (
    Message message, 
    Object obj
)

JScript

public final function Write (
    message : Message, 
    obj : Object
)

パラメータ

message

Body プロパティにシリアル化されたオブジェクトが含まれる Message。

obj

メッセージ本文にシリアル化されるオブジェクト。

例外

例外の種類	条件
ArgumentNullException	message パラメータが null 参照 (Visual Basic では Nothing) です。

解説

キューに書き込む場合は、トップ オブジェクトの形式と型の形式を指定する必要はありません。読み取るときに指定する必要があります。フォーマッタは、メッセージを逆シリアル化するときにだけ、TopObjectFormat プロパティおよび TypeFormat プロパティを使用します。

BinaryMessageFormatter は、ほとんどのオブジェクトをシリアル化できますが、その結果は疎結合にはなりません。ただし、コンパクトになるので、大きなオブジェクトの場合には、フォーマッタを使用するのが効率的です。

.NET Framework のセキュリティ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
BinaryMessageFormatter クラス
BinaryMessageFormatter メンバ
System.Messaging 名前空間
Read