XmlReader.ReadToDescendant Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

System.Xml.ReaderWriter.dll

Memajukan XmlReader ke elemen turunan yang cocok berikutnya.

Overload

ReadToDescendant(String, String)	Memajukan XmlReader ke elemen turunan berikutnya dengan nama lokal dan URI namespace yang ditentukan.
ReadToDescendant(String)	Memajukan XmlReader ke elemen turunan berikutnya dengan nama yang memenuhi syarat yang ditentukan.

ReadToDescendant(String, String)

Sumber:

XmlReader.cs

Memajukan XmlReader ke elemen turunan berikutnya dengan nama lokal dan URI namespace yang ditentukan.

public:
 virtual bool ReadToDescendant(System::String ^ localName, System::String ^ namespaceURI);

public virtual bool ReadToDescendant (string localName, string namespaceURI);

abstract member ReadToDescendant : string * string -> bool
override this.ReadToDescendant : string * string -> bool

Public Overridable Function ReadToDescendant (localName As String, namespaceURI As String) As Boolean

Parameter

localName

String

Nama lokal elemen yang ingin Anda pindahkan.

namespaceURI

String

URI namespace elemen yang ingin Anda pindahkan.

Mengembalikan

Boolean

true jika elemen keturunan yang cocok ditemukan; jika tidak false. Jika elemen turunan yang cocok tidak ditemukan, XmlReader diposisikan pada tag akhir (NodeType adalah XmlNodeType.EndElement) dari elemen .

XmlReader Jika tidak diposisikan pada elemen ketika ReadToDescendant(String, String) dipanggil, metode ini mengembalikan false dan posisi XmlReader tidak diubah.

Pengecualian

InvalidOperationException

Metode XmlReader dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

ArgumentNullException

Kedua nilai parameter adalah null.

ReadToDescendant(String)

Sumber:

XmlReader.cs

Memajukan XmlReader ke elemen turunan berikutnya dengan nama yang memenuhi syarat yang ditentukan.

public:
 virtual bool ReadToDescendant(System::String ^ name);

public virtual bool ReadToDescendant (string name);

abstract member ReadToDescendant : string -> bool
override this.ReadToDescendant : string -> bool

Public Overridable Function ReadToDescendant (name As String) As Boolean

Parameter

name

String

Nama elemen yang memenuhi syarat yang ingin Anda pindahkan.

Mengembalikan

Boolean

true jika elemen keturunan yang cocok ditemukan; jika tidak false. Jika elemen turunan yang cocok tidak ditemukan, XmlReader diposisikan pada tag akhir (NodeType adalah XmlNodeType.EndElement) dari elemen .

XmlReader Jika tidak diposisikan pada elemen ketika ReadToDescendant(String) dipanggil, metode ini mengembalikan false dan posisi XmlReader tidak diubah.

Pengecualian

InvalidOperationException

Metode XmlReader dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

ArgumentException

Parameter adalah string kosong.

Contoh

Contoh berikut mengurai simpul buku kedua.

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());
}

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

Contohnya menggunakan file , 2books.xml, sebagai input.

<!--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>