XmlReader.ReadContentAsObject メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

現在の位置でテキストコンテンツを 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

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

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

文字列書式が無効です。

先行の非同期操作が完了する前に、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。