XmlReader.ReadContentAsString メソッド

.NET Framework クラス ライブラリ リファレンス

XmlReader.ReadContentAsString メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 ReadContentAsString As String

Visual Basic (使用法)

Dim instance As XmlReader
Dim returnValue As String

returnValue = instance.ReadContentAsString

C#

public virtual string ReadContentAsString ()

C++

public:
virtual String^ ReadContentAsString ()

J#

public String ReadContentAsString ()

JScript

public function ReadContentAsString () : String

戻り値
String オブジェクトとしてのテキストの内容。

例外

例外の種類	条件
InvalidCastException	試行されたキャストが無効です。
FormatException	文字列書式が無効です。

解説

このメソッドは、テキスト、空白、有意の空白、および 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 がスローされます。	未定義。ただし、リーダー (読み取り機能) は現在の位置にとどまるのが一般的です。

詳細については、「型指定されたデータの読み取り」および W3C 勧告『XML Schema Part 2: Datatypes』(http://www.w3.org/TR/xmlschema-2/) を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
XmlReader クラス
XmlReader メンバ
System.Xml 名前空間
その他の技術情報
型指定されたデータの読み取り