XmlReader.Skip Método

Definición

Espacio de nombres:

System.Xml

Ensamblados:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlReader.cs

Omite los nodos secundarios del nodo actual.

C#

public virtual void Skip();

Excepciones

InvalidOperationException

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.

Ejemplos

En el ejemplo siguiente se analiza un archivo XML a partir del segundo nodo de libro.

C#

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

En el ejemplo se usa el archivo , 2books.xmlcomo entrada.

XML

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

Comentarios

En la siguiente entrada XML si el lector está situado en el <a> nodo o en cualquiera de sus atributos, al llamar a Skip coloca el lector en el <b> nodo.

Si el lector ya está colocado en un nodo hoja (como el <x> nodo o el nodo abcde texto), llamar Skip a es el mismo que llamar a Read.

XML

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

Este método comprueba si hay XML bien formado.

Si el lector es , XmlValidatingReadereste método también valida el contenido omitido.

La XmlReader implementación determina si el Skip método expandirá o no las entidades externas. En la tabla siguiente se describe si las entidades externas se expanden para los distintos tipos de XmlReader objetos.

Tipo de XmlReader	Expande entidades externas
XmlTextReader	No.
XmlReader instancia creada por el Create método que está leyendo datos de texto.	No.
XmlReader instancia creada por el Create método que está leyendo datos binarios.	No es aplicable.
Una instancia de validación XmlReader de esquema creada por el Create método .	Sí.
XmlValidatingReader	Sí.
XmlReader instancia devuelta por un XPathNavigator objeto .	No es aplicable.
XmlNodeReader	No.
XmlReader instancia encapsulada alrededor de otra XmlReader instancia.	Depende de la implementación del subyacente XmlReader. (Se Skip llama al método en el subyacente XmlReader ).

Para obtener la versión asincrónica de este método, vea SkipAsync.

Se aplica a