XmlReader.ReadToDescendant Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Přejde na XmlReader další odpovídající následný prvek.

Přetížení

Name	Description
ReadToDescendant(String, String)	Přejde na XmlReader další potomk element se zadaným místním názvem a identifikátorem URI oboru názvů.
ReadToDescendant(String)	Přejde na XmlReader další následný prvek se zadaným kvalifikovaným názvem.

ReadToDescendant(String, String)

Zdroj:

XmlReader.cs

Přejde na XmlReader další potomk element se zadaným místním názvem a identifikátorem URI oboru názvů.

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

Parametry

localName

String

Místní název prvku, na který chcete přejít.

namespaceURI

String

Identifikátor URI oboru názvů elementu, na který chcete přejít.

Návraty

Boolean

true pokud je nalezen odpovídající potomk prvek; jinak false. Pokud se nenajde odpovídající následný prvek, XmlReader umístí se na koncovou značku (NodeType je XmlNodeType.EndElement) prvku.

XmlReader Pokud není umístěn na prvku při ReadToDescendant(String, String) zavolání, tato metoda vrátí false a pozice XmlReader není změněna.

Výjimky

InvalidOperationException

Před XmlReader dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

ArgumentNullException

Obě hodnoty parametrů jsou null.

ReadToDescendant(String)

Zdroj:

XmlReader.cs

Přejde na XmlReader další následný prvek se zadaným kvalifikovaným názvem.

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

Parametry

name

String

Kvalifikovaný název prvku, na který chcete přejít.

Návraty

Boolean

true pokud je nalezen odpovídající potomk prvek; jinak false. Pokud se nenajde odpovídající následný prvek, XmlReader umístí se na koncovou značku (NodeType je XmlNodeType.EndElement) prvku.

XmlReader Pokud není umístěn na prvku při ReadToDescendant(String) zavolání, tato metoda vrátí false a pozice XmlReader není změněna.

Výjimky

InvalidOperationException

Před XmlReader dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

ArgumentException

Parametr je prázdný řetězec.

Příklady

Následující příklad analyzuje druhý uzel knihy.

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

Příklad používá soubor , 2books.xmljako vstup.

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