XmlReader.ReadToDescendant Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

XmlReader Przechodzi do następnego pasującego elementu podrzędnego.

Przeciążenia

ReadToDescendant(String, String)	XmlReader Przechodzi do następnego elementu podrzędnego z określoną lokalną nazwą i identyfikatorem URI przestrzeni nazw.
ReadToDescendant(String)	XmlReader Przechodzi do następnego elementu potomnego z określoną kwalifikowaną nazwą.

ReadToDescendant(String, String)

Źródło:

XmlReader.cs

XmlReader Przechodzi do następnego elementu podrzędnego z określoną lokalną nazwą i identyfikatorem URI przestrzeni nazw.

C#

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

Parametry

localName

String

Lokalna nazwa elementu, do którego chcesz przejść.

namespaceURI

String

Identyfikator URI przestrzeni nazw elementu, do którego chcesz przejść.

Zwraca

Boolean

true jeśli zostanie znaleziony pasujący element potomny; w przeciwnym razie false. Jeśli pasujący element potomny nie zostanie znaleziony, XmlReader element zostanie umieszczony na tagu końcowym (NodeType to XmlNodeType.EndElement) elementu.

Jeśli element XmlReader nie jest umieszczony w elemecie , gdy ReadToDescendant(String, String) został wywołany, ta metoda zwraca wartość false i pozycja elementu XmlReader nie zostanie zmieniona.

Wyjątki

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

ArgumentNullException

Obie wartości parametrów to null.

ReadToDescendant(String)

Źródło:

XmlReader.cs

XmlReader Przechodzi do następnego elementu potomnego z określoną kwalifikowaną nazwą.

C#

public virtual bool ReadToDescendant (string name);

Parametry

name

String

Kwalifikowana nazwa elementu, do którego chcesz przejść.

Zwraca

Boolean

true jeśli zostanie znaleziony pasujący element potomny; w przeciwnym razie false. Jeśli pasujący element potomny nie zostanie znaleziony, XmlReader element zostanie umieszczony na tagu końcowym (NodeType to XmlNodeType.EndElement) elementu.

Jeśli element XmlReader nie jest umieszczony w elemecie , gdy ReadToDescendant(String) został wywołany, ta metoda zwraca wartość false i pozycja elementu XmlReader nie zostanie zmieniona.

Wyjątki

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

ArgumentException

Parametr jest pustym ciągiem.

Przykłady

Poniższy przykład analizuje drugi węzeł książki.

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

W przykładzie użyto pliku , 2books.xmljako danych wejściowych.

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>