XmlReader.ReadString メソッド

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

XmlReader.ReadString メソッド

派生クラスでオーバーライドされると、要素ノードまたはテキスト ノードの内容を文字列として読み取ります。

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

Visual Basic (宣言)

Public Overridable Function
 ReadString As String

Visual Basic (使用法)

Dim instance As XmlReader
Dim returnValue As String

returnValue = instance.ReadString

C#

public virtual string ReadString ()

C++

public:
virtual String^ ReadString ()

J#

public String ReadString ()

JScript

public function ReadString () : String

戻り値
要素の内容または空の文字列。

例外

例外の種類	条件
XmlException	XML の解析中にエラーが発生しました。

解説

このメソッドは、要素の内容、テキスト、空白、有意の空白、または CDATA ノードを返します。

要素に配置すると、ReadString は、すべてのテキスト、有意な空白、空白、および CDATA セクション ノードを連結し、連結したデータを要素の内容として返します。これは、任意のマークアップが見つかった時点で停止します。コメントや処理命令もマークアップと見なされます。これは、混合コンテンツ モデル内で、または要素終了タグが読み取られるときに、発生する可能性があります。

要素のテキスト ノードに配置されると、ReadString は、テキスト ノードから要素終了タグへの連結を実行します。リーダーが属性テキスト ノードに配置されている場合、ReadString は、リーダーが要素開始タグに配置されている場合と同じ機能を持ちます。連結された要素テキスト ノードをすべて返します。

リーダーが属性に配置されている場合、ReadString は空の文字列を返し、その属性を所有する要素までリーダーの位置を戻します。

それ以外のノード タイプで ReadString を呼び出した場合は、空の文字列が返され、リーダーが次のノード位置に配置されます。

使用例

各要素のテキストの内容を表示する例を次に示します。

Visual Basic

Using reader As XmlReader = XmlReader.Create("book3.xml")
               
  ' Parse the XML document.  ReadString is used to 
  ' read the text content of the elements.
  reader.Read()
  reader.ReadStartElement("book")
  reader.ReadStartElement("title")
  Console.Write("The content of the title element:  ")
  Console.WriteLine(reader.ReadString())
  reader.ReadEndElement()
  reader.ReadStartElement("price")
  Console.Write("The content of the price element:  ")
  Console.WriteLine(reader.ReadString())
  reader.ReadEndElement()
  reader.ReadEndElement()            
End Using

C#

using (XmlReader reader = XmlReader.Create("book3.xml"))
 {

  // Parse the XML document.  ReadString is used to 
  // read the text content of the elements.
  reader.Read(); 
  reader.ReadStartElement("book");  
  reader.ReadStartElement("title");   
  Console.Write("The content of the title element:  ");
  Console.WriteLine(reader.ReadString());
  reader.ReadEndElement();
  reader.ReadStartElement("price");
  Console.Write("The content of the price element:  ");
  Console.WriteLine(reader.ReadString());
  reader.ReadEndElement();
  reader.ReadEndElement();

}

この例では、book3.xml ファイルを使用しています。

<book>
  <title>Pride And
 Prejudice</title>
  <price>19.95</price>
</book>

プラットフォーム

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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlReader クラス
XmlReader メンバ
System.Xml 名前空間
その他の技術情報
XmlReader による XML の読み取り