IXmlPullParser.NextToken Método

Definición

Espacio de nombres:

Org.XmlPull.V1

Ensamblado:

Mono.Android.dll

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

XmlPullParserNode

Atributos

RegisterAttribute

Excepciones

XmlPullParserException

IOException

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 el 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 está normalizado de fin de 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:dldtSTART_DOCUMENTddnull dtEND_DOCUMENT dd null dtSTART_TAGddnull a menos que FEATURE_XML_ROUNDTRIP habilitado y, a continuación, devuelva la etiqueta XML, por ejemplo: < tag attr='val'dt END_TAG ddnull a menos que FEATURE_XML_ROUNDTRIP id habilitado y, a continuación, devuelva la etiqueta XML, por ejemplo: dtTEXTddreturn element content. <Br>Nota: ese contenido de elemento puede entregarse en varios eventos TEXT consecutivos. <dt>IGNORABLE_WHITESPACE<caracteres devueltos dd>que se determinan como espacios en blanco ignorables. Si el FEATURE_XML_ROUNDTRIP está habilitado, todo el contenido del espacio en blanco fuera del elemento raíz siempre se notificará como IGNORABLE_WHITESPACE de lo contrario, los informes son opcionales. <Br>Nota: el contenido del elemento puede entregarse en varios eventos de IGNORABLE_WHITESPACE consecutivos. dtCDSECTdd return text eminside/em CDATA (por ejemplo, 'fo< o' de ) dtPROCESSING_INSTRUCTIONdd si FEATURE_XML_ROUNDTRIP es true devuelve contenido de PI exacto, por ejemplo: 'pi foo' de de lo contrario, puede ser exactamente contenido de PI o concatenación de destino pi, espacio y datos, por ejemplo, para cadena " datos de destino" se puede devolver si FEATURE_XML_ROUNDTRIP es false. <dt>COMMENT dd>return comment<content ex. 'foo bar' de dtENTITY_REFddgetText() DEBE devolver texto de reemplazo de entidad si PROCESS_DOCDECL es false en caso contrario getText() MAY devolver null, además getTextCharacters() DEBE devolver el nombre de entidad (por ejemplo, "entity_name" para & entity_name;). <br><b>NOTE:</b> este es el único lugar donde el valor devuelto de getText() y getTextCharacters() <b>son diferentes</b><br><b>NOTE:</b> es responsabilidad del usuario resolver la referencia de entidad si PROCESS_DOCDECL es false y no hay ningún conjunto de texto de reemplazo de entidad en el método defineEntityReplacementText() (getText() será null) <br><b>NOTE:</b> Entidades de caracteres (por ejemplo, ) y entidades estándar como & amp; & lt; & gt; & quot; & ap; también se notifican y son <b>no< b> notificados como tokens TEXT, pero como tokens de ENTITY_REF! Este requisito se agrega para permitir realizar recorridos de ida y vuelta de documentos XML. <dt>DOCDECL<dd> si FEATURE_XML_ROUNDTRIP es true o PROCESS_DOCDECL es false, devuelve lo que está dentro de DOCDECL, por ejemplo, devuelve:

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

strongNOTE:/strong XMLDecl () no se notifica, pero su contenido está disponible a través de propiedades opcionales (consulte la descripción de la clase anterior).

Java documentación para org.xmlpull.v1.XmlPullParser.nextToken().

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.