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を参照してください。

このページはお役に立ちましたか?