XmlReader.ReadContentAsObject メソッド

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

XmlReader.ReadContentAsObject メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

現在の位置でテキストの内容を Object として読み取ります。

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

Visual Basic (宣言)

Public Overridable Function
 ReadContentAsObject As Object

Visual Basic (使用法)

Dim instance As XmlReader
Dim returnValue As Object

returnValue = instance.ReadContentAsObject

C#

public virtual Object ReadContentAsObject ()

C++

public:
virtual Object^ ReadContentAsObject ()

J#

public Object ReadContentAsObject ()

JScript

public function ReadContentAsObject () : Object

戻り値
最も適切な共通言語ランタイム (CLR) オブジェクトとしてのテキストの内容。

例外

例外の種類	条件
InvalidCastException	試行されたキャストが無効です。
FormatException	文字列書式が無効です。

解説

このメソッドは、テキスト、空白、有意の空白、および CDATA セクションを連結し、すべてのコメントまたは処理命令をスキップします。エンティティ参照は自動的に解決されます。

内容が型指定されている場合、リーダーは、ValueType プロパティで指定された最も適切な型のボックス化された CLR を返します。内容がリスト型の場合、このリーダーは適切な型のボックス化されたオブジェクトの配列を返します。

メモ
内容を解析しているときに検証エラーが発生し、リーダーが Create メソッドで作成された XmlReader オブジェクトの場合、リーダーは内容を文字列として返します。つまり、検証のエラーまたは警告が発生すると、内容は型指定されていないものとして扱われます。

内容が型指定されていない場合、リーダーは内容を文字列として返します。

このメソッドで各ノード型がどのように処理されるかについて、次の表に示します。

XmlNodeType	戻り値	リーダーの動作
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	連結されたテキストの内容、CDATA、空白、および要求された型に変換された有意な空白ノード。	次の開始要素タグまたは終了要素タグに移動します。エンティティ参照は自動的に展開されます。
Attribute	属性値による XmlConvert.ToXxx の呼び出しと同じ。	リーダーは、現在の位置から変わりません。
Comment ProcessingInstruction	処理命令 (PI) またはコメントを無視し、PI またはコメントに続く、連結されたテキストの内容を読み込みます。	次の開始要素タグまたは終了要素タグに移動します。エンティティ参照は自動的に展開されます。
EndElement	リーダーが (ValidationType が Schema に設定された) スキーマ検証リーダーである場合は要素の値。それ以外の場合は空の文字列。	リーダーは、現在の位置から変わりません。
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	InvalidOperationException がスローされます。	未定義。ただし、リーダー (読み取り機能) は現在の位置にとどまるのが一般的です。

詳細については、「型指定されたデータの読み取り」および W3C 勧告『XML Schema Part 2: Datatypes』(http://www.w3.org/TR/xmlschema-2/) を参照してください。

プラットフォーム

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
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
XmlReader クラス
XmlReader メンバ
System.Xml 名前空間
その他の技術情報
型指定されたデータの読み取り