XmlReader.Skip Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Pomija elementy podrzędne bieżącego węzła.

public:
 virtual void Skip();

public virtual void Skip ();

abstract member Skip : unit -> unit
override this.Skip : unit -> unit

Public Overridable Sub Skip ()

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".

Przykłady

Poniższy przykład analizuje plik XML rozpoczynający się w drugim węźle książki.

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

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

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

Uwagi

W następujących danych wejściowych XML, jeśli czytnik jest umieszczony w węźle <a> lub dowolnym z jego atrybutów, wywołując Skip pozycję czytelnika do węzła <b> .

Jeśli czytnik jest już umieszczony w węźle liścia (takim jak <x> węzeł lub węzeł abctekstowy), wywołanie jest takie samo jak wywołanie Skip metody Read.

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

Ta metoda sprawdza prawidłowo sformułowany kod XML.

Jeśli czytelnik jest elementem XmlValidatingReader, ta metoda weryfikuje również pominiętą zawartość.

Implementacja XmlReader określa, czy Skip metoda rozszerzy jednostki zewnętrzne. W poniższej tabeli opisano, czy jednostki zewnętrzne są rozszerzane dla różnych typów XmlReader obiektów.

Typ elementu XmlReader	Rozszerza jednostki zewnętrzne
XmlTextReader	Nie.
XmlReader wystąpienie utworzone przez metodę Create , która odczytuje dane tekstowe.	Nie.
XmlReader wystąpienie utworzone przez metodę Create , która odczytuje dane binarne.	Nie dotyczy.
Schemat sprawdzania poprawności XmlReader wystąpienia utworzonego przez metodę Create .	Tak.
XmlValidatingReader	Tak.
XmlReader wystąpienie zwracane przez XPathNavigator obiekt.	Nie dotyczy.
XmlNodeReader	Nie.
XmlReader wystąpienie opakowane wokół innego XmlReader wystąpienia.	Zależy od implementacji bazowego XmlReaderobiektu . (Wywoływana Skip jest metoda na serwerze bazowym XmlReader ).

Aby uzyskać asynchroniczną wersję tej metody, zobacz SkipAsync.