XmlReader.ReadToNextSibling Método

Definición

Hace avanzar el objeto XmlReader hasta el siguiente elemento relacionado coincidente.

Sobrecargas

ReadToNextSibling(String)

Hace avanzar el objeto XmlReader hasta al siguiente elemento relacionado con el nombre completo especificado.

ReadToNextSibling(String, String)

Hace avanzar el objeto XmlReader al siguiente elemento del mismo nivel que tenga el URI del espacio de nombres y el nombre local especificados.

ReadToNextSibling(String)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Hace avanzar el objeto XmlReader hasta al siguiente elemento relacionado con el nombre completo especificado.

public virtual bool ReadToNextSibling (string name);

Parámetros

name
String

Nombre completo del elemento relacionado al que se desea desplazar.

Devoluciones

Es true si se encuentra un elemento relacionado; en caso contrario, es false. Si no se encuentra ningún elemento relacionado, el objeto XmlReader se coloca en la etiqueta de cierre (NodeType es XmlNodeType.EndElement) del elemento principal.

Excepciones

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

El parámetro es una cadena vacía.

Ejemplos

En el ejemplo siguiente se lee el atributo ISBN en cada nodo de libro.

using (XmlReader reader = XmlReader.Create("books.xml")) {
    reader.ReadToFollowing("book");
    do {
       Console.WriteLine("ISBN: {0}", reader.GetAttribute("ISBN"));
    } while (reader.ReadToNextSibling("book"));
}

Comentarios

Nota

No llame a ReadToNextSibling cuando XmlReader es un estado inicial (ReadState es Initial). Puede llamar Read a para avanzar y XmlReader , a continuación, llamar al ReadToNextSibling método .

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

ReadToNextSibling(String, String)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Hace avanzar el objeto XmlReader al siguiente elemento del mismo nivel que tenga el URI del espacio de nombres y el nombre local especificados.

public virtual bool ReadToNextSibling (string localName, string namespaceURI);

Parámetros

localName
String

Nombre local del elemento relacionado al que se desea desplazar.

namespaceURI
String

URI del espacio de nombres del elemento relacionado al que se desea desplazar.

Devoluciones

Es true si se encuentra un elemento relacionado; en caso contrario, es false. Si no se encuentra ningún elemento relacionado, el objeto XmlReader se coloca en la etiqueta de cierre (NodeType es XmlNodeType.EndElement) del elemento principal.

Excepciones

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

Ambos valores del parámetro son null.

Comentarios

Nota

No llame a ReadToNextSibling cuando XmlReader es un estado inicial (ReadState es Initial). Puede llamar Read a para avanzar y XmlReader , a continuación, llamar al ReadToNextSibling método .

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0