XmlMessageFormatter.CanRead メソッド

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

XmlMessageFormatter.CanRead メソッド

フォーマッタがメッセージを逆シリアル化できるかどうかを判断します。

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

Visual Basic (宣言)

Public Function CanRead ( _
    message As Message _
) As Boolean

Visual Basic (使用法)

Dim instance As XmlMessageFormatter
Dim message As Message
Dim returnValue As Boolean

returnValue = instance.CanRead(message)

C#

public bool CanRead (
    Message message
)

C++

public:
virtual bool CanRead (
    Message^ message
) sealed

J#

public final boolean CanRead (
    Message message
)

JScript

public final function CanRead (
    message : Message
) : boolean

パラメータ

message

検査する Message。

戻り値
XML フォーマッタがメッセージを逆シリアル化できる場合は true。それ以外の場合は false。

例外

例外の種類	条件
InvalidOperationException	TargetTypeNames プロパティも TargetTypes プロパティも設定されていません。
ArgumentNullException	message パラメータが null 参照 (Visual Basic では Nothing) です。

解説

CanRead が呼び出されると、フォーマッタ ツールはメッセージの内容を逆シリアル化できるかどうかを判断しようとします。メッセージ本文の型のスキーマが TargetTypeNames プロパティおよび TargetTypes プロパティで表された配列に含まれているいずれかの型のスキーマと同じ場合にだけ、フォーマッタはメッセージを逆シリアル化できます。CanRead は、次の 2 つの場合に false を返します。

• メッセージが XmlMessageFormatter を使用して書式指定されていない場合。

• メッセージ本文のスキーマが TargetTypeNames プロパティまたは TargetTypes プロパティに含まれていない場合。

TargetTypeNames プロパティおよび TargetTypes プロパティによって、フォーマッタは逆シリアル化できるオブジェクトの型がわかります。型がリストになく、メッセージに含まれている場合、CanRead は false を返します。

.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 名前空間
TargetTypes
TargetTypeNames
BinaryMessageFormatter クラス
ActiveXMessageFormatter クラス