XmlReader.Skip-Methode

Überspringt die untergeordneten Elemente des aktuellen Knotens.

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Overridable Sub Skip
'Usage
Dim instance As XmlReader

instance.Skip

public virtual void Skip ()

public:
virtual void Skip ()

public void Skip ()

public function Skip ()

Hinweise

Wenn der Reader bei Eingabe von folgendem XML-Code auf dem <a>-Knoten oder auf einem von dessen Attributen positioniert ist, wird er beim Aufruf von Skip auf den <b>-Knoten verschoben.

Wenn der Reader bereits auf einem Endknoten (z. B. auf dem <x>-Knoten oder dem Textknoten abc) positioniert ist, entspricht der Aufruf von Skip einem Aufruf von Read.

 <a name="bob" age="123">
  <x/>abc<y/>
 </a>
 <b>
 ...
 </b>

Diese Methode prüft auf wohlgeformtes XML.

Wenn der Reader ein XmlValidatingReader ist, validiert diese Methode auch den übersprungenen Inhalt.

Die XmlReader-Implementierung bestimmt, ob die Skip-Methode externe Entitäten erweitert. In der folgenden Tabelle wird beschrieben, ob die externen Entitäten für die verschiedenen Typen von XmlReader-Objekten erweitert werden.

TyType von XmlReader	ExExpands externe Entitäten
XmlTextReader	Nein.
XmlReader-Instanz, die von der Create-Methode erstellt wurde, die Textdaten liest.	Nein.
XmlReader-Instanz, die von der Create-Methode erstellt wurde, die binäre Daten liest.	Nicht zutreffend.
Eine XmlReader-Instanz zur Schemavalidierung, die von der Create-Methode erstellt wurde.	Ja.
XmlValidatingReader	Ja.
Von einem XPathNavigator-Objekt zurückgegebene XmlReader-Instanz.	Nicht zutreffend.
XmlNodeReader	Nein.
Eine XmlReader-Instanz, die eine weitere XmlReader-Instanz umgibt.	Je nach Implementierung des zugrunde liegenden XmlReader. (Die Skip-Methode für den zugrunde liegenden XmlReader wird aufgerufen).

Beispiel

Im folgenden Beispiel wird eine XML-Datei ab dem zweiten Buchknoten analysiert.

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

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

}

Im Beispiel wird die Datei 2books.xml als Eingabe verwendet.

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlReader-Klasse
XmlReader-Member
System.Xml-Namespace

Weitere Ressourcen

Lesen von XML mit dem "XmlReader"