IXmlPullParser.NextToken Méthode

Définition

Espace de noms:

Org.XmlPull.V1

Assembly:

Mono.Android.dll

Cette méthode fonctionne de la même façon que next(), mais expose des types d’événements supplémentaires (COMMENT, CDSECT, DOCDECL, ENTITY_REF, PROCESSING_INSTRUCTION ou IGNORABLE_WHITESPACE) s’ils sont disponibles en entrée.

[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

Retours

XmlPullParserNode

Attributs

RegisterAttribute

Exceptions

XmlPullParserException

IOException

Remarques

Cette méthode fonctionne de la même façon que next(), mais expose des types d’événements supplémentaires (COMMENT, CDSECT, DOCDECL, ENTITY_REF, PROCESSING_INSTRUCTION ou IGNORABLE_WHITESPACE) s’ils sont disponibles en entrée.

Si une fonctionnalité spéciale FEATURE_XML_ROUNDTRIP (identifiée par l’URI : http://xmlpull.org/v1/doc/features.html#xml-roundtrip) est activée, il est possible d’effectuer un aller-retour de document XML, par exemple. reproduire en sortie l’entrée XML à l’aide de getText() : le contenu retourné est toujours nonnormalisé (exactement comme en entrée). Sinon, le contenu retourné est normalisé en fin de ligne, comme décrit la gestion de fin de ligne XML 1.0 et. En outre, lorsque cette fonctionnalité est activée, le contenu exact de START_TAG, END_TAG, DOCDECL et PROCESSING_INSTRUCTION est disponible.

Voici la liste des jetons qui peuvent être retournés à partir de nextToken() et de getText() et getTextCharacters() retourne :<dl dl><dt>START_DOCUMENT<dd null <dt>END_DOCUMENT<dd>null <dt>START_TAG<dd>>null, sauf si FEATURE_XML_ROUNDTRIP activé, puis retourne la balise XML, ex : < tag attr='val’dt END_TAG dd>null, sauf si FEATURE_XML_ROUNDTRIP ID activé, puis retourne la balise XML, ex :

" titlepage SYSTEM "http://www.foo.bar/dtds/typo.dtd"
            [<!ENTITY % active.links "INCLUDE">]"

pour le document d’entrée contenu :

<!DOCTYPE titlepage SYSTEM "http://www.foo.bar/dtds/typo.dtd"
            [<!ENTITY % active.links "INCLUDE">]>

sinon, si FEATURE_XML_ROUNDTRIP a la valeur false et que PROCESS_DOCDECL a la valeur true, ce qui est retourné est non défini (il peut être même null) </dd></dl>

<>strong REMARQUE :</strong> il n’existe aucune garantie qu’il n’y aura qu’un seul événement TEXT ou IGNORABLE_WHITESPACE de nextToken(), car l’analyseur peut choisir de fournir du contenu d’élément dans plusieurs jetons (divisant le contenu de l’élément en blocs)

<strong>REMARQUE :</strong> si le texte retourné du jeton est normalisé en fin de ligne dépend de FEATURE_XML_ROUNDTRIP.

<strong>REMARQUE :</strong> XMLDecl (< ? xml ... ? >) n’est pas signalé, mais son contenu est disponible via des propriétés facultatives (voir la description de classe ci-dessus).

Documentation Java pour org.xmlpull.v1.XmlPullParser.nextToken().

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.