XmlReader.ReadElementString メソッド ()

テキストだけの要素を読み取ります。

Overloads Public Overridable Function ReadElementString() As String
[C#]
public virtual string ReadElementString();
[C++]
public: virtual String* ReadElementString();
[JScript]
public function ReadElementString() : String;

戻り値

読み取られた要素内に格納されているテキスト。要素が空 (<item></item> または <item/>) の場合は、空の文字列。

例外

例外の種類	条件
XmlException	次のコンテンツ ノードが開始タグでないか、見つかった要素に単純なテキスト値が格納されていません。

解説

これは、単純なテキストだけの要素を読み取るためのヘルパ メソッドです。 MoveToContent を呼び出して、次のコンテンツ ノードを検索してから、その値を単純文字列として解析します。

XML、 <name>Arlene Huff</name> 、 ReadElementString を使用すると、要素が処理され、文字列 Arlene Huff が返されます。

このメソッドは name 要素内のマークアップ (子要素、コメント、処理命令など) を処理できませんが、複数の隣接したテキスト ブロックと CDATA ブロックを連結できます。

使用例

[Visual Basic, C#, C++] ReadElementString を使用して、要素ノードの内容を読み取る例を次に示します。

 
Imports System
Imports System.Xml

public class Sample

  private const filename as string = "book.xml"

  public shared Sub Main()

    Dim reader as XmlTextReader = Nothing

    try
       
      'Load the file and ignore all whitespace.
      reader = new XmlTextReader(filename)
      reader.WhitespaceHandling = WhitespaceHandling.None

      'Moves the reader to the root element.
      reader.MoveToContent()

      'Read the title and price elements.
      Console.WriteLine("Content of the title element: {0}", reader.ReadElementString())
      Console.WriteLine("Content of the price element: {0}", reader.ReadElementString())

    finally
      if Not reader Is Nothing
        reader.Close()
      End if
    End try

  End Sub
End class

[C#] 
using System;
using System.Xml;

public class Sample
{
  private const String filename = "book.xml";

  public static void Main()
  {
    XmlTextReader reader = null;

    try
    {           
      //Load the file and ignore all whitespace.
      reader = new XmlTextReader(filename);
      reader.WhitespaceHandling = WhitespaceHandling.None;

      //Moves the reader to the root element.
      reader.MoveToContent();

      //Read the title and price elements.
      Console.WriteLine("Content of the title element: {0}", reader.ReadElementString());
      Console.WriteLine("Content of the price element: {0}", reader.ReadElementString());; 
         
    }
    finally
    {
      if (reader!=null)
        reader.Close();
    }
  }
} // End class

[C++] 
#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::Xml;


int main()
{
   String* filename = S"book.xml";
   XmlTextReader* reader = 0;

   try
   {           
      //Load the file and ignore all whitespace.
      reader = new XmlTextReader(filename);
      reader->WhitespaceHandling = WhitespaceHandling::None;

      //Moves the reader to the root element.
      reader->MoveToContent();

      //Read the title and price elements.
      Console::WriteLine(S"Content of the title element: {0}", reader->ReadElementString());
      Console::WriteLine(S"Content of the price element: {0}", reader->ReadElementString());

   }
   __finally
   {
      if (reader!=0)
         reader->Close();
   }
}

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

<!--sample XML fragment-->
<book genre='novel' ISBN='1-861003-78' misc='sale-item'>
  <title>The Handmaid's Tale</title>
  <price>14.95</price>
</book>

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

XmlReader クラス | XmlReader メンバ | System.Xml 名前空間 | XmlReader.ReadElementString オーバーロードの一覧