XmlMessageFormatter.Read メソッド

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

XmlMessageFormatter.Read メソッド

指定されたメッセージから内容を読み取り、逆シリアル化されたメッセージを格納するオブジェクトを作成します。

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

Visual Basic (宣言)

Public Function Read ( _
    message As Message _
) As Object

Visual Basic (使用法)

Dim instance As XmlMessageFormatter
Dim message As Message
Dim returnValue As Object

returnValue = instance.Read(message)

C#

public Object Read (
    Message message
)

C++

public:
virtual Object^ Read (
    Message^ message
) sealed

J#

public final Object Read (
    Message message
)

JScript

public final function Read (
    message : Message
) : Object

パラメータ

message

逆シリアル化する XML 形式の Message。

戻り値
逆シリアル化されたメッセージ。

例外

例外の種類	条件
InvalidOperationException	TargetTypeNames プロパティも TargetTypes プロパティも設定されていません。 または メッセージ本文でシリアル化されるインスタンスが、TargetTypeNames プロパティおよび TargetTypes プロパティの型で表されたスキーマに従っていません。
ArgumentNullException	message パラメータが null 参照 (Visual Basic では Nothing) です。

解説

TargetTypeNames プロパティおよび TargetTypes プロパティの設定により、フォーマッタがメッセージの逆シリアル化時に一致させようとするスキーマが決まります。メッセージを逆シリアル化する前に、これらのプロパティのいずれかを設定する必要があります。

メッセージ本文でシリアル化されるインスタンスは、型配列で表されたスキーマの 1 つに従っている必要があります。Receive メソッドを使用してメッセージを読み取る場合は、識別されたスキーマに対応する型のオブジェクトがこのメソッドによって作成され、そこにメッセージ本文が読み込まれます。

キューに書き込むために対象の型を指定する必要はありません。

.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

参照

関連項目
XmlMessageFormatter クラス
XmlMessageFormatter メンバ
System.Messaging 名前空間
CanRead
Write
TargetTypeNames
TargetTypes
Message クラス