次の方法で共有


XmlReader.ReadContentAsString メソッド

定義

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

例外

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

文字列書式が無効です。

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

適用対象