XmlReader.ReadContentAsString メソッド

定義

重要

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

現在の位置でテキストコンテンツを String オブジェクトとして読み取ります。

public:
 virtual System::String ^ ReadContentAsString();

public virtual string ReadContentAsString ();

abstract member ReadContentAsString : unit -> string
override this.ReadContentAsString : unit -> string

Public Overridable Function ReadContentAsString () As String

String

String オブジェクトとしてのテキストコンテンツ。

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

文字列書式が無効です。

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

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

このメソッドは、型指定された値を文字列に変換したり、コメントや処理命令をスキップしながらテキストコンテンツを読み取ったりするために使用できます。

次の表では、このメソッドが各ノードの種類を処理する方法について説明します。

XmlNodeType	戻り値	リーダーの動作
`Text` `CDATA` `Whitespace` `SignificantWhitespace` `EntityReference` `EndEntity`	テキストの連結されたコンテンツ、CDATA、空白、および有意の空白のノードが指定された型に変換されます。	次の要素開始タグまたは要素終了タグに移動します。エンティティ参照は自動的に展開されます。
`Attribute`	属性値でを呼び出す `XmlConvert.ToXxx` のと同じです。	リーダは現在の位置に留まります。
`Comment` `ProcessingInstruction`	処理命令 (PI) またはコメントは無視し、PI またはコメントに続く連結されたテキストコンテンツを読みます。	次の要素開始タグまたは要素終了タグに移動します。エンティティ参照は自動的に展開されます。
`EndElement`	空の文字列。	リーダは現在の位置に留まります。
`Element` `XmlDeclaration` `None` `Document` `DocumentType` `Notation` `Entity` `DocumentFragment`	InvalidOperationException がスローされます。	未定義。ただし、リーダーは通常、現在の位置に留まります。

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

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