XmlReader.ReadToFollowing Método
Definición
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í.
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.
public:
virtual bool ReadToFollowing(System::String ^ name);public virtual bool ReadToFollowing (string name);abstract member ReadToFollowing : string -> bool
override this.ReadToFollowing : string -> boolPublic Overridable Function ReadToFollowing (name As String) As BooleanParámetros
- name
- String
Nombre completo del elemento.
Devoluciones
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
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.
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.
<!--"sample.xml"-->
<?xml version="1.0">
<items>
<item xmls="urn:1"/>
</items>
</xml>
XmlTextReader reader = newXmlTextReader("sample.xml");
reader.ReadToFollowing("item");
Se puede llamar a este método en todos los tipos de nodo.
Se aplica a
ReadToFollowing(String, String)
Lee hasta que encuentra un elemento con el nombre local y el URI de espacio de nombres especificados.
public:
virtual bool ReadToFollowing(System::String ^ localName, System::String ^ namespaceURI);public virtual bool ReadToFollowing (string localName, string namespaceURI);abstract member ReadToFollowing : string * string -> bool
override this.ReadToFollowing : string * string -> boolPublic Overridable Function ReadToFollowing (localName As String, namespaceURI As String) As BooleanParámetros
- localName
- String
Nombre local del elemento.
- namespaceURI
- String
Identificador URI de espacio de nombres del elemento.
Devoluciones
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
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
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.
<!--"sample.xml"-->
<?xml version="1.0">
<items>
<item xmls="urn:1"/>
</items>
</xml>
XmlTextReader reader = newXmlTextReader("sample.xml");
reader.ReadToFollowing("item", "urn:1");
Se puede llamar a este método en todos los tipos de nodo.