IXmlPullParser.NextToken 方法

定義

命名空間:: Org.XmlPull.V1

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

此方法的運作方式與 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

傳回

XmlPullParserNode

屬性: RegisterAttribute

例外狀況

XmlPullParserException

IOException

備註

此方法的運作方式與 next（）類似，但若輸入中有其他事件類型（COMMENT、CDSECT、DOCDECL、ENTITY_REF、PROCESSING_INSTRUCTION 或 IGNORABLE_WHITESPACE）會暴露。

若啟用特殊功能 FEATURE_XML_ROUNDTRIP （以 URI： http://xmlpull.org/v1/doc/features.html#xml-roundtrip) 識別），則可進行 XML 文件來回，即在輸出時精確重現 XML 輸入，使用 getText（）：回傳內容始終未正規化（與輸入相同）。否則回傳的內容會依 XML 1.0 終端處理方式進行線末標準化。啟用此功能後，START_TAG、END_TAG、DOCDECL及PROCESSING_INSTRUCTION的精確內容也可取得。

以下是可從 nextToken（）回傳的權杖清單，以及 getText（）和 getTextCharacters（）回傳的條件：dldtSTART_DOCUMENTddnull dtEND_DOCUMENTddnull dtSTART_TAGdd null，除非啟用 FEATURE_XML_ROUNDTRIP 然後回傳 XML 標籤，例如： END_TAGddnull，除非啟用 FEATURE_XML_ROUNDTRIP id，然後回傳 XML 標籤，例如：dtTEXTdd回傳元素內容。 注意：該元素內容可在多個連續的 TEXT 事件中傳遞。 <DT>IGNORABLE_WHITESPACE<DD>回傳被認定為可忽略空白的字元。若啟用FEATURE_XML_ROUNDTRIP，根元素以外的空白內容將永遠以IGNORABLE_WHITESPACE否則回報為可選。 注意：該元素內容可在多個連續的 IGNORABLE_WHITESPACE 事件中傳遞。 dtCDSECTdd 回傳 text eminside/em CDATA（例如 'fo<喔，從 <！CDATA[fo） dtPROCESSING_INSTRUCTIONdd 如果FEATURE_XML_ROUNDTRIP為真請回傳精確的 PI 內容，例如：'pi foo' from <？Pi Foo？否則可能是精確的 PI 內容，或是 PI 目標、空間與資料的串接，例如 <？目標資料？ string ”目標資料”若FEATURE_XML_ROUNDTRIP為假，則可返回。 <dt>留言<dd>回覆留言內容例如。《Foo Bar》出自《<！》--foo bar--dtENTITY_REFddgetText（）必須回傳實體替換文字如果 PROCESS_DOCDECL 為假，否則 getText（）可能回傳 null，此外 getTextCharacters（）必須回傳實體名稱（例如 & 的 'entity_name'entity_name;）。 這是唯一從 getText（）和 getTextCharacters（） 回傳的值不同<的地方/b> <>注意： PROCESS_DOCDECL如果 entity 引用為假且 defineEntityReplacementText（）方法<>>><<中沒有設定實體替換文字，則使用者有責任解析實體引用>><字元實體（例如）以及標準實體如 &&它;>&「」'也被報告，且 b>不是< 以文字標記（TEXT token）報告，而是以 ENTITY_REF 標記形式報告！這個要求是為了允許往返 XML 文件！ <dt>DOCDECL<dd> 如果 FEATURE_XML_ROUNDTRIP 為真或 PROCESS_DOCDECL 為假，則回傳 DOCDECL 內部的內容，例如回傳：

&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 為假且 PROCESS_DOCDECL 為真，則回傳的為未定義（甚至可能是空）/ <dd></dl>

注意： 無法保證 nextToken（）只會有一個 TEXT 或 IGNORABLE_WHITESPACE 事件，因為解析器可能會選擇將元素內容分成多個 token（將元素內容分割成區塊）

<強>注意：</強> 回傳的令牌文字是否為行尾正規化，取決於FEATURE_XML_ROUNDTRIP。

strongNOTE：/strong XMLDecl （<？XML ...？>）未報告，但其內容可透過選用屬性取得（見上文類別描述）。

的 org.xmlpull.v1.XmlPullParser.nextToken()Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於