IXmlPullParser.NextToken 方法

定义

此方法的工作方式类似于 next(),但如果这些类型在输入中可用,则会公开其他事件类型(COMMENT、CDSECT、DOCDECL、ENTITY_REF、PROCESSING_INSTRUCTION 或 IGNORABLE_WHITESPACE)。

[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

返回

属性

例外

注解

此方法的工作方式类似于 next(),但如果这些类型在输入中可用,则会公开其他事件类型(COMMENT、CDSECT、DOCDECL、ENTITY_REF、PROCESSING_INSTRUCTION 或 IGNORABLE_WHITESPACE)。

如果特殊功能 FEATURE_XML_ROUNDTRIP (通过 URI 标识:已启用: http://xmlpull.org/v1/doc/features.html#xml-roundtrip) 可以执行 XML 文档往返操作)。使用 getText()在输出 XML 输入时重现错误。返回的内容始终未规范化(完全与输入中一样)。 否则,返回的内容按 XML 1.0 行尾处理和描述的行尾规范化。 此外,当启用此功能时,START_TAG、END_TAG、DOCDECL 和PROCESSING_INSTRUCTION的确切内容可用。

下面是可从 nextToken() 返回的令牌列表,以及 getTextCharacters() 和 getTextCharacters() 返回:<dl<>dt START_DOCUMENT dd>null dt>END_DOCUMENT dd>null dt>>START_TAG<<<dd>null<<,除非FEATURE_XML_ROUNDTRIP已启用,然后返回 XML 标记,例如:

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

对于包含:

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

否则,如果FEATURE_XML_ROUNDTRIP为 false,PROCESS_DOCDECL为 true,则返回的内容未定义(甚至为 null) </dd></dl>

<strong NOTE:</strong>> 无法保证 nextToken()中只有一个 TEXT 或 IGNORABLE_WHITESPACE 事件,因为分析器可以选择在多个令牌中传递元素内容(将元素内容划分为区块)

<strong NOTE:</strong>> whether returned text of token is end-of-line normalized is depend on FEATURE_XML_ROUNDTRIP.

<strong NOTE:</strong>> XMLDecl (<?xml ...?>)未报告,但其内容可通过可选属性提供(请参阅上面的类说明)。

适用于 . 的 org.xmlpull.v1.XmlPullParser.nextToken()Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于