XmlReader.Skip Metodo

Definizione

Spazio dei nomi:
System.Xml
Assembly:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assembly:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Origine:
XmlReader.cs
Origine:
XmlReader.cs
Origine:
XmlReader.cs
Origine:
XmlReader.cs
Origine:
XmlReader.cs

Ignora gli elementi figlio del nodo corrente.

public:
 virtual void Skip();
public virtual void Skip();
abstract member Skip : unit -> unit
override this.Skip : unit -> unit
Public Overridable Sub Skip ()

Eccezioni

InvalidOperationException

È stato chiamato un XmlReader metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".

Esempio

Nell'esempio seguente viene analizzato un file XML a partire dal secondo nodo libro.

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

Nell'esempio viene usato il file , 2books.xml, come input.

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

Commenti

Nell'input XML seguente se il lettore è posizionato sul <a> nodo o su uno dei relativi attributi, chiamando Skip posiziona il lettore nel <b> nodo.

Se il lettore è già posizionato in un nodo foglia ,ad esempio il <x> nodo o il nodo abcdi testo , la chiamata Skip è uguale a quella di .Read

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

Questo metodo controlla la presenza di codice XML ben formato.

Se il lettore è un oggetto XmlValidatingReader, questo metodo convalida anche il contenuto ignorato.

L'implementazione XmlReader determina se il Skip metodo espanderà o meno le entità esterne. Nella tabella seguente viene descritto se le entità esterne vengono espanse per i vari tipi di XmlReader oggetti.

Tipo di XmlReader Espande le entità esterne
XmlTextReader No.
XmlReader istanza creata dal Create metodo che legge i dati di testo. No.
XmlReader istanza creata dal Create metodo che legge i dati binari. Non applicabile.
Istanza di XmlReader convalida dello schema creata dal Create metodo . Yes.
XmlValidatingReader Yes.
XmlReader istanza restituita da un XPathNavigator oggetto . Non applicabile.
XmlNodeReader No.
XmlReader istanza di cui è stato eseguito il wrapping intorno a un'altra XmlReader istanza. Dipende dall'implementazione dell'oggetto sottostante XmlReader. (Viene chiamato il Skip metodo sull'oggetto sottostante XmlReader ).

Per la versione asincrona di questo metodo, vedere SkipAsync.

Si applica a