XmlReader.ReadToNextSibling Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

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

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

Boolean

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

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

ArgumentException

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 .

ReadToNextSibling(String, String)

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

Boolean

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

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

ArgumentNullException

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 .