XmlReader.ReadContentAsString XmlReader.ReadContentAsString XmlReader.ReadContentAsString XmlReader.ReadContentAsString Method

定義

現在の位置でテキスト コンテンツを String オブジェクトとして読み取ります。Reads the text content at the current position as a String object.

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 オブジェクトとしてのテキスト コンテンツ。The text content as a String object.

例外

試行されたキャストが無効です。The attempted cast is not valid.

文字列書式が無効です。The string format is not valid.

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。An XmlReader method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

注釈

このメソッドは、テキスト、空白、有意の空白、および CDATA セクションを連結し、コメントや処理命令をスキップします。This method concatenates text, white space, significant white space, and CDATA sections, and skips any comments or processing instructions. エンティティ参照は自動的に解決されます。Entity references are automatically resolved.

このメソッドを使用して、型指定された値を文字列に変換したり、コメントや処理命令をスキップしながらテキストの内容を読み取ったりすることができます。This method can be used convert typed values to a string, or to read the text content while skipping comments and processing instructions.

次の表では、このメソッドが各ノード型を処理する方法について説明します。The following table describes how this method treats each node type.

XmlNodeTypeXmlNodeType 戻り値Return value リーダーの動作Reader behavior
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity
テキストの連結されたコンテンツ、CDATA、空白、および有意の空白のノードが指定された型に変換されます。Concatenated content of text, CDATA, white space and significant white space nodes converted to the requested type. 次の要素開始タグまたは要素終了タグに移動します。Moves to the next start element or end element tag. エンティティ参照は自動的に展開されます。Entity references are automatically expanded.
Attribute 属性値にXmlConvert.ToXxx対してを呼び出す場合と同じです。Same as calling XmlConvert.ToXxx on the attribute value. リーダは現在の位置に留まります。The reader remains in the current position.
Comment

ProcessingInstruction
処理命令 (PI) またはコメントは無視し、PI またはコメントに続く連結されたテキスト コンテンツを読みます。Ignores the processing instruction (PI) or comment and reads the concatenated text content that follows the PI or comment. 次の要素開始タグまたは要素終了タグに移動します。Moves to the next start element or end element tag. エンティティ参照は自動的に展開されます。Entity references are automatically expanded.
EndElement 空の文字列。An empty string. リーダは現在の位置に留まります。The reader remains in the current position.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment
InvalidOperationException がスローされます。An InvalidOperationException is thrown. 未定義。ただし、リーダーは通常、現在の位置に留まります。Undefined, although typically the reader remains in the current position.

詳細については、 XmlReaderリファレンスページの「解説」 と W3C XML Schema Part 2 を参照してください。データ型の推奨。For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

このメソッドの非同期バージョンについてはReadContentAsStringAsync、「」を参照してください。For the asynchronous version of this method, see ReadContentAsStringAsync.

適用対象