XmlReader.ReadStartElement メソッド (String)

現在のコンテンツ ノードが、指定した Name を持つ要素で、リーダーを次のノードに進めることを確認します。

Overloads Public Overridable Sub ReadStartElement( _
   ByVal name As String _)
[C#]
public virtual void ReadStartElement(stringname);
[C++]
public: virtual void ReadStartElement(String* name);
[JScript]
public function ReadStartElement(
   name : String);

パラメータ

• name
  要素の限定名。

例外

例外の種類	条件
XmlException	IsStartElement が false を返すか、要素の Name が指定した name と一致しません。

解説

このメソッドの呼び出しは、 IsStartElement の呼び出しとその後の Read の呼び出しに対応しています。

使用例

[Visual Basic, C#, C++] ReadStartElement メソッドと ReadEndElement メソッドを使用して XML ドキュメントを解析する例を次に示します。

 
Imports System
Imports System.IO
Imports System.Xml

public class Sample 

  public shared sub Main()

     'Create the reader.
     Dim reader as XmlTextReader = new XmlTextReader("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()

     'Close the reader.
     reader.Close()
     
  end sub
end class

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

public class Sample 
{
  public static void Main()
  {

     //Create the reader.
     XmlTextReader  reader = new XmlTextReader("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();

     //Close the reader.
     reader.Close();
     
  }
} // End class

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

int main()
{
   // Create the reader.
   XmlTextReader* reader = new XmlTextReader(S"book3.xml");

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

   // Close the reader.
   reader -> Close();     
}

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

<book>
  <title>Pride And Prejudice</title>
  <price>19.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.ReadStartElement オーバーロードの一覧 | ReadEndElement