IXmlPullParser.NextToken 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í.
Este método funciona de forma similar a next(), pero expondrá tipos de eventos adicionales (COMMENT, CDSECT, DOCDECL, ENTITY_REF, PROCESSING_INSTRUCTION o IGNORABLE_WHITESPACE) si están disponibles en la entrada.
[Android.Runtime.Register("nextToken", "()I", "GetNextTokenHandler:Org.XmlPull.V1.IXmlPullParserInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.XmlPull.V1.XmlPullParserNode NextToken ();
[<Android.Runtime.Register("nextToken", "()I", "GetNextTokenHandler:Org.XmlPull.V1.IXmlPullParserInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member NextToken : unit -> Org.XmlPull.V1.XmlPullParserNode
Devoluciones
- Atributos
Excepciones
Comentarios
Este método funciona de forma similar a next(), pero expondrá tipos de eventos adicionales (COMMENT, CDSECT, DOCDECL, ENTITY_REF, PROCESSING_INSTRUCTION o IGNORABLE_WHITESPACE) si están disponibles en la entrada.
Si la característica especial FEATURE_XML_ROUNDTRIP (identificada por URI: http://xmlpull.org/v1/doc/features.html#xml-roundtrip) está habilitada, es posible realizar un recorrido de ida y vuelta de documentos XML, es decir, reproducirse de forma exectly en la salida de la entrada XML mediante getText(): el contenido devuelto siempre no está normalizado (exactamente como en la entrada). De lo contrario, el contenido devuelto se normaliza al final de la línea, tal como se describe en XML 1.0 End-of-Line Handling y . También cuando esta característica está habilitada con contenido exacto de START_TAG, END_TAG, DOCDECL y PROCESSING_INSTRUCTION está disponible.
Esta es la lista de tokens que se pueden devolver desde nextToken() y qué getText() y getTextCharacters() devuelve:<dl><dt>START_DOCUMENT<dd>null <dt>END_DOCUMENT dd null dt>START_TAG<<dd>>null <a menos que FEATURE_XML_ROUNDTRIP habilitado y, a continuación, devuelva la etiqueta XML, por ejemplo: < tag attr='val'dt END_TAG dd>null a menos que FEATURE_XML_ROUNDTRIP id habilitado y, a continuación, devuelva la etiqueta XML, por ejemplo:
" titlepage SYSTEM "http://www.foo.bar/dtds/typo.dtd"
[<!ENTITY % active.links "INCLUDE">]"
para el documento de entrada que contenía:
<!DOCTYPE titlepage SYSTEM "http://www.foo.bar/dtds/typo.dtd"
[<!ENTITY % active.links "INCLUDE">]>
De lo contrario, si FEATURE_XML_ROUNDTRIP es false y PROCESS_DOCDECL es true, lo que se devuelve es indefinido (puede ser incluso null) </dd></dl>
<nota fuerte>:</strong> no hay ninguna garantía de que solo haya un evento TEXT o IGNORABLE_WHITESPACE de nextToken() como analizador puede optar por entregar contenido de elementos en varios tokens (dividir el contenido del elemento en fragmentos).
<strong>NOTE:</strong> si el texto devuelto del token está normalizado de un extremo de línea depende de FEATURE_XML_ROUNDTRIP.
<strong>NOTE:</strong> XMLDecl () no se notifica, pero su contenido está disponible a través de propiedades opcionales (consulte la descripción de la clase anterior).
Documentación de Java para org.xmlpull.v1.XmlPullParser.nextToken()
.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.