フォーマッタがメッセージを逆シリアル化できるかどうかを判断します。
Public Overridable Function CanRead( _
ByVal message As Message _) As Boolean Implements IMessageFormatter.CanRead
[C#]
public virtual bool CanRead(Messagemessage);
[C++]
public: virtual bool CanRead(Message* message);
[JScript]
public 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 を返します。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用
参照
XmlMessageFormatter クラス | XmlMessageFormatter メンバ | System.Messaging 名前空間 | TargetTypes | TargetTypeNames | BinaryMessageFormatter | ActiveXMessageFormatter