XmlReader.ReadToFollowing Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

Lee hasta que encuentra el elemento con nombre.

Sobrecargas

ReadToFollowing(String)	Lee hasta que encuentra un elemento con el nombre completo especificado.
ReadToFollowing(String, String)	Lee hasta que encuentra un elemento con el nombre local y el URI de espacio de nombres especificados.

ReadToFollowing(String)

Lee hasta que encuentra un elemento con el nombre completo especificado.

C#

public virtual bool ReadToFollowing (string name);

Parámetros

name

String

Nombre completo del elemento.

Devoluciones

Boolean

Es true si se encuentra un elemento coincidente; de lo contrario, es false y el objeto XmlReader está en un estado de final de archivo.

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.

Comentarios

Este método es funcionalmente equivalente a ejecutar la following::name expresión XPath desde el nodo actual. Proporciona una manera rápida de buscar un elemento con nombre en el documento XML. Avanza el lector al siguiente elemento que coincide con el nombre especificado y devuelve true si se encuentra un elemento coincidente. Con el ejemplo siguiente, el lector leería la primera instancia del elemento especificado mientras lee hacia delante.

XML

<!--"sample.xml"-->
<?xml version="1.0">
   <items>
      <item xmls="urn:1"/>
   </items>
</xml>

C#

XmlTextReader reader = newXmlTextReader("sample.xml");

reader.ReadToFollowing("item");

Se puede llamar a este método en todos los tipos de nodo.

ReadToFollowing(String, String)

Lee hasta que encuentra un elemento con el nombre local y el URI de espacio de nombres especificados.

C#

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

Parámetros

localName

String

Nombre local del elemento.

namespaceURI

String

Identificador URI de espacio de nombres del elemento.

Devoluciones

Boolean

Es true si se encuentra un elemento coincidente; de lo contrario, es false y el objeto XmlReader está en un estado de final de archivo.

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

Este método es funcionalmente equivalente a ejecutar la following::name expresión XPath desde el nodo actual. Proporciona una manera rápida de buscar un elemento con nombre en el documento XML. Avanza el lector al siguiente elemento que coincide con el nombre especificado y devuelve true si se encuentra un elemento coincidente.

XML

<!--"sample.xml"-->
<?xml version="1.0">
   <items>
      <item xmls="urn:1"/>
   </items>
</xml>

C#

XmlTextReader reader = newXmlTextReader("sample.xml");

reader.ReadToFollowing("item", "urn:1");

Se puede llamar a este método en todos los tipos de nodo.