XmlReader.ReadToDescendant Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

öğesini XmlReader sonraki eşleşen alt öğeye ilerler.

Aşırı Yüklemeler

Name	Description
ReadToDescendant(String, String)	öğesini belirtilen yerel ad ve ad alanı URI'siyle sonraki alt öğeye ilerler XmlReader .
ReadToDescendant(String)	öğesini belirtilen nitelenmiş adla sonraki alt öğeye ilerler XmlReader .

ReadToDescendant(String, String)

Kaynak:

XmlReader.cs

öğesini belirtilen yerel ad ve ad alanı URI'siyle sonraki alt öğeye ilerler XmlReader .

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

Parametreler

localName

String

Taşımak istediğiniz öğenin yerel adı.

namespaceURI

String

Taşımak istediğiniz öğenin ad alanı URI'si.

Döndürülenler

Boolean

true eşleşen bir alt öğe bulunursa; aksi takdirde false. Eşleşen bir alt öğe bulunamazsa, XmlReader öğesinin bitiş etiketine (NodeType is XmlNodeType.EndElement) konumlandırılır.

XmlReader çağrıldığında ReadToDescendant(String, String) öğesinde konumlandırılmazsa, bu yöntem döndürür false ve öğesinin XmlReader konumu değiştirilmez.

Özel durumlar

InvalidOperationException

Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

ArgumentNullException

Her iki parametre değeri de şeklindedir null.

ReadToDescendant(String)

Kaynak:

XmlReader.cs

öğesini belirtilen nitelenmiş adla sonraki alt öğeye ilerler XmlReader .

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

Parametreler

name

String

Taşımak istediğiniz öğenin tam adı.

Döndürülenler

Boolean

true eşleşen bir alt öğe bulunursa; aksi takdirde false. Eşleşen bir alt öğe bulunamazsa, XmlReader öğesinin bitiş etiketine (NodeType is XmlNodeType.EndElement) konumlandırılır.

XmlReader çağrıldığında ReadToDescendant(String) öğesinde konumlandırılmazsa, bu yöntem döndürür false ve öğesinin XmlReader konumu değiştirilmez.

Özel durumlar

InvalidOperationException

Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

ArgumentException

parametresi boş bir dizedir.

Örnekler

Aşağıdaki örnek ikinci kitap düğümünü ayrıştırmaktadır.

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

Örnekte giriş 2books.xmlolarak dosyası kullanılır.

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