XmlReader.ReadContentAsString メソッド

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

ソース:

XmlReader.cs

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

例外

InvalidCastException

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

FormatException

文字列書式が無効です。

InvalidOperationException

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