次の方法で共有


XmlReader.ReadContentAsObject メソッド

定義

現在の位置でテキスト コンテンツを 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) オブジェクトとしてのテキストの内容。

例外

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

文字列書式が無効です。

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

適用対象