XmlReader.ReadToDescendant Methode

Definitie

Naamruimte:
System.Xml
Assembly's:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
netstandard.dll

Hiermee gaat u naar XmlReader het volgende overeenkomende onderliggende element.

Overloads

Name Description
ReadToDescendant(String, String)

Hiermee gaat u naar XmlReader het volgende onderliggende element met de opgegeven lokale naam en naamruimte-URI.
ReadToDescendant(String)

Hiermee gaat u naar XmlReader het volgende onderliggende element met de opgegeven gekwalificeerde naam.

ReadToDescendant(String, String)

Hiermee gaat u naar XmlReader het volgende onderliggende element met de opgegeven lokale naam en naamruimte-URI.

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

Parameters

localName
String

De lokale naam van het element waarnaar u wilt gaan.

namespaceURI
String

De naamruimte-URI van het element waarnaar u wilt gaan.

Retouren

Boolean

true als een overeenkomend afstammelingselement wordt gevonden; anders false. Als een overeenkomend afstammelingselement niet wordt gevonden, wordt het XmlReader element op de eindtag (NodeType is XmlNodeType.EndElement) van het element weergegeven.

Als de XmlReader methode niet op een element ReadToDescendant(String, String) wordt aangeroepen, wordt deze methode geretourneerd false en wordt de positie van de XmlReader methode niet gewijzigd.

Uitzonderingen

InvalidOperationException

Er XmlReader is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.

ArgumentNullException

Beide parameterwaarden zijn null.

Van toepassing op

ReadToDescendant(String)

Hiermee gaat u naar XmlReader het volgende onderliggende element met de opgegeven gekwalificeerde naam.

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

Parameters

name
String

De gekwalificeerde naam van het element waarnaar u wilt overstappen.

Retouren

Boolean

true als een overeenkomend afstammelingselement wordt gevonden; anders false. Als een overeenkomend afstammelingselement niet wordt gevonden, wordt het XmlReader element op de eindtag (NodeType is XmlNodeType.EndElement) van het element weergegeven.

Als de XmlReader methode niet op een element ReadToDescendant(String) wordt aangeroepen, wordt deze methode geretourneerd false en wordt de positie van de XmlReader methode niet gewijzigd.

Uitzonderingen

InvalidOperationException

Er XmlReader is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.

ArgumentException

De parameter is een lege tekenreeks.

Voorbeelden

In het volgende voorbeeld wordt het tweede boekknooppunt geparseerd.

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

In het voorbeeld wordt het bestand als 2books.xmlinvoer gebruikt.

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

Van toepassing op