IXmlPullParser.NextToken Methode

[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

Gibt zurück

Attribute

RegisterAttribute

Ausnahmen

Hinweise

Diese Methode funktioniert ähnlich wie next() aber macht zusätzliche Ereignistypen (COMMENT, CDSECT, DOCDECL, ENTITY_REF, PROCESSING_INSTRUCTION oder IGNORABLE_WHITESPACE) verfügbar, wenn sie in der Eingabe verfügbar sind.

Wenn spezielle Funktion FEATURE_XML_ROUNDTRIP (identifiziert durch URI: http://xmlpull.org/v1/doc/features.html#xml-roundtrip) ist aktiviert, ist es möglich, XML-Dokument roundtrip ie durchzuführen. Reproduzieren Sie exectly bei der Ausgabe der XML-Eingabe mithilfe von getText(): Zurückgegebener Inhalt ist immer nicht normalisiert (genau wie in der Eingabe). Andernfalls werden zurückgegebene Inhalte gemäß der Beschreibung von XML 1.0 Ende-of-Line Handling und Ende-of-Line normalisiert. Wenn dieses Feature auch exakten Inhalt von START_TAG aktiviert ist, ist END_TAG, DOCDECL und PROCESSING_INSTRUCTION verfügbar.

Dies ist die Liste der Token, die von nextToken() zurückgegeben werden können, und was getText() und getTextCharacters() returns:dldt START_DOCUMENTddnull dtEND_DOCUMENTddnull dtSTART_TAGddnull, es sei denn, FEATURE_XML_ROUNDTRIP aktiviert und gibt dann XML-Tag zurück, z. B. < tag attr='val'dt END_TAG ddnull, es sei denn, FEATURE_XML_ROUNDTRIP ID aktiviert und gibt dann XML-Tag zurück, z. B.: dtTEXTddreturn element content. <br>Hinweis: Dieser Elementinhalt kann in mehreren aufeinander folgenden TEXT-Ereignissen übermittelt werden. <dt>IGNORABLE_WHITESPACE<dd-Rückgabezeichen>, die als nicht leerer Leerraum bestimmt sind. Wenn die FEATURE_XML_ROUNDTRIP aktiviert ist, werden alle Leerzeicheninhalte außerhalb des Stammelements immer als IGNORABLE_WHITESPACE andernfalls ist die Berichterstellung optional. <br>Note: that element content may be delivered in multiple consecutive IGNORABLE_WHITESPACE events. dtCDSECTdd return text eminside/em CDATA (z. B. 'fo< o' von ) dtPROCESSING_INSTRUCTIONdd , wenn FEATURE_XML_ROUNDTRIP genaue PI-Inhalte zurückgibt, z. B. "pi foo" von andernfalls kann es sich um genaue PI-Inhalte oder Verkettung von PI-Ziel-, Raum- und Datendaten, z. B. für Zeichenfolge " Zieldaten" kann zurückgegeben werden, wenn FEATURE_XML_ROUNDTRIP "false" ist. <dt>COMMENT<dd gibt Kommentarinhalt z.>B. zurück. 'foo bar' von dtENTITY_REFddgetText() MUST return entity replacement text if PROCESS_DOCDECL is false otherwise getText() MAY return null, additionally getTextCharacters() MUST return entity name (for example 'entity_name' for & & entity_name;). <br><b>HINWEIS:</b> Dies ist der einzige Ort, an dem der von getText() zurückgegebene Wert und getTextCharacters() <b>unterscheiden</b br><b>><NOTE:</b> benutzerverantwortlich ist, Entitätsreferenz aufzulösen, wenn PROCESS_DOCDECL falsch ist und kein Entitätsersetzungstextsatz in der defineEntityReplacementText() -Methode (getText() ist null) <br><b>NOTE:</b> Zeichenentitäten (z. B. ) und Standardentitäten wie & amp; & lt; & gt; & quot; & apos; werden ebenfalls gemeldet und werden <>nicht</b> als TEXT-Token, sondern als ENTITY_REF Token gemeldet! Diese Anforderung wird hinzugefügt, um das Roundtrip von XML-Dokumenten zu ermöglichen! <dt>DOCDECL<dd> , wenn FEATURE_XML_ROUNDTRIP "true" ist oder PROCESS_DOCDECL "false" ist, gibt dann zurück, was in DOCDECL enthalten ist, z. B.:

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

für Eingabedokument, das Folgendes enthält:

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

andernfalls, wenn FEATURE_XML_ROUNDTRIP "false" ist und PROCESS_DOCDECL "true" ist, ist der zurückgegebene Wert nicht definiert (es kann sogar null sein) </dd></dl>

<starke>NOTE:</strong> es gibt keine Garantie dafür, dass nur ein TEXT- oder IGNORABLE_WHITESPACE-Ereignis aus nextToken() vorhanden ist, da der Parser sich für die Bereitstellung von Elementinhalten in mehreren Token entscheiden kann (Aufteilen von Elementinhalten in Blöcke)

<starke>NOTE:</strong> , ob der zurückgegebene Text des Tokens end-of-line normalisiert ist, hängt von FEATURE_XML_ROUNDTRIP ab.

strongNOTE:/strong XMLDecl () wird nicht gemeldet, aber sein Inhalt ist über optionale Eigenschaften verfügbar (siehe Klassenbeschreibung oben).

Java Dokumentation für org.xmlpull.v1.XmlPullParser.nextToken().

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.