XmlReader.ReadContentAsObject メソッド

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

アセンブリ:

System.Xml.dll

アセンブリ:

netstandard.dll

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

public:
 virtual System::Object ^ ReadContentAsObject();

public virtual object ReadContentAsObject ();

abstract member ReadContentAsObject : unit -> obj
override this.ReadContentAsObject : unit -> obj

Public Overridable Function ReadContentAsObject () As Object

戻り値

Object

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

例外

InvalidCastException

試行されたキャストが無効です。

FormatException

文字列書式が無効です。

InvalidOperationException

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

注釈

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

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

注意

コンテンツの解析中に検証エラーが発生し、リーダーがメソッドによって作成された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 がスローされます。	未定義。ただし、リーダーは通常、現在の位置に留まります。

詳細については、リファレンス ページの XmlReader 「解説」セクションと W3C XML スキーマ パート 2: データ型に関する推奨事項を 参照してください。

このメソッドの非同期バージョンについては、次を参照してください ReadContentAsObjectAsync。