XmlReader.ReadToNextSibling Método
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Hace avanzar el objeto XmlReader
hasta el siguiente elemento relacionado coincidente.
ReadToNextSibling(String) |
Hace avanzar el objeto |
ReadToNextSibling(String, String) |
Hace avanzar el objeto |
- 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(System::String ^ name);
public virtual bool ReadToNextSibling (string name);
abstract member ReadToNextSibling : string -> bool
override this.ReadToNextSibling : string -> bool
Public Overridable Function ReadToNextSibling (name As String) As Boolean
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"));
}
Using reader As XmlReader = XmlReader.Create("books.xml")
reader.ReadToFollowing("book")
Do
Console.WriteLine("ISBN: {0}", reader.GetAttribute("ISBN"))
Loop While reader.ReadToNextSibling("book")
End Using
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 |
- 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(System::String ^ localName, System::String ^ namespaceURI);
public virtual bool ReadToNextSibling (string localName, string namespaceURI);
abstract member ReadToNextSibling : string * string -> bool
override this.ReadToNextSibling : string * string -> bool
Public Overridable Function ReadToNextSibling (localName As String, namespaceURI As String) As Boolean
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 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: