XmlReader.ReadToDescendant

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

XmlReader.ReadToDescendant メソッド (String)

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

指定された修飾名を使用して XmlReader を次の子孫要素に進めます。

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

Visual Basic (宣言)

Public Overridable Function
 ReadToDescendant ( _
    name As String _
) As Boolean

Visual Basic (使用法)

Dim instance As XmlReader
Dim name As String
Dim returnValue As Boolean

returnValue = instance.ReadToDescendant(name)

C#

public virtual bool ReadToDescendant (
    string name
)

C++

public:
virtual bool ReadToDescendant (
    String^ name
)

J#

public boolean ReadToDescendant (
    String name
)

JScript

public function ReadToDescendant (
    name : String
) : boolean

パラメータ

name

移動先となる要素の修飾名。

戻り値
一致する子孫要素が見つかった場合は true。それ以外の場合は false。一致する子孫要素が見つからない場合、要素の終了タグ (NodeType が XmlNodeType.EndElement) に XmlReader が配置されます。 ReadToDescendant が呼び出されたときに XmlReader が要素に配置されていない場合、このメソッドは false を返し、XmlReader の位置を変更しません。

使用例

2 番目の book ノードを解析する例を次に示します。

Visual Basic

Using reader As XmlReader = XmlReader.Create("2books.xml")

  ' Move the reader to the second book node.
  reader.MoveToContent()
  reader.ReadToDescendant("book")
  reader.Skip() 'Skip the first book.
  ' Parse the file starting with the second book node.
  Do
    Select Case reader.NodeType
      Case XmlNodeType.Element
        Console.Write("<{0}", reader.Name)
        While reader.MoveToNextAttribute()
            Console.Write(" {0}='{1}'", reader.Name, reader.Value)
        End While
        Console.Write(">")
      Case XmlNodeType.Text
        Console.Write(reader.Value)
      Case XmlNodeType.EndElement
        Console.Write("</{0}>", reader.Name)
    End Select
  Loop While reader.Read()

End Using

C#

using (XmlReader reader = XmlReader.Create("2books.xml"))
 {

  // Move the reader to the second book node.
  reader.MoveToContent(); 
  reader.ReadToDescendant("book");
  reader.Skip(); //Skip the first book.

  // Parse the file starting with the second book node.
  do {
     switch (reader.NodeType) {
        case XmlNodeType.Element:
           Console.Write("<{0}", reader.Name);
           while (reader.MoveToNextAttribute()) {
               Console.Write(" {0}='{1}'", reader.Name, reader.Value);
           }
           Console.Write(">");
           break;
        case XmlNodeType.Text:
           Console.Write(reader.Value);
           break;
        case XmlNodeType.EndElement:
           Console.Write("</{0}>", reader.Name);
           break;
     }       
  }  while (reader.Read());    

}

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

<!--sample XML fragment-->
<bookstore>
  <book genre='novel' ISBN='10-861003-324'>
    <title>The Handmaid's
 Tale</title>
    <price>19.95</price>
  </book>
  <book genre='novel' ISBN='1-861001-57-5'>
    <title>Pride
 And Prejudice</title>
    <price>24.95</price>
  </book>
</bookstore>

プラットフォーム

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 名前空間
その他の技術情報
XmlReader による XML の読み取り
XmlReader による XML の読み取り

XmlReader.ReadToDescendant メソッド

XmlReader を次に一致する子孫要素に進めます。
オーバーロードの一覧

名前	説明
XmlReader.ReadToDescendant (String)	指定された修飾名を使用して XmlReader を次の子孫要素に進めます。 .NET Compact Framework によってサポートされています。
XmlReader.ReadToDescendant (String, String)	指定されたローカル名と名前空間 URI を使用して XmlReader を次の子孫要素に進めます。 .NET Compact Framework によってサポートされています。

参照

関連項目

XmlReader クラス
XmlReader メンバ
System.Xml 名前空間

その他の技術情報

XmlReader による XML の読み取り
XmlReader による XML の読み取り

XmlReader による XML の読み取り