語言

IEntityResolver2.GetExternalSubset(String, String) 方法

定義

允許應用程式為未明確定義的文件提供外部子集。

[Android.Runtime.Register("getExternalSubset", "(Ljava/lang/String;Ljava/lang/String;)Lorg/xml/sax/InputSource;", "GetGetExternalSubset_Ljava_lang_String_Ljava_lang_String_Handler:Org.Xml.Sax.Ext.IEntityResolver2Invoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.Xml.Sax.InputSource? GetExternalSubset(string? name, string? baseURI);
[<Android.Runtime.Register("getExternalSubset", "(Ljava/lang/String;Ljava/lang/String;)Lorg/xml/sax/InputSource;", "GetGetExternalSubset_Ljava_lang_String_Ljava_lang_String_Handler:Org.Xml.Sax.Ext.IEntityResolver2Invoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member GetExternalSubset : string * string -> Org.Xml.Sax.InputSource

參數

name
String

識別文件根元素。 此名稱來自 DOCTYPE 宣告(如有)或實際的根元素。

baseURI
String

文件的基礎 URI,作為選擇外部子集的額外提示。 這永遠是絕對 URI,除非是空的,因為 XMLReader 被賦予了沒有 URI 的 InputSource。

傳回

一個描述解析器將使用的新外部子集的 InputSource 物件,或用空物件表示未提供外部子集。

屬性

例外狀況

任何 SAX 例外,可能還會封裝另一個例外。

這很可能表示未建立新的 InputStream 或 Reader,或是使用了非法 URL。

備註

允許應用程式為未明確定義的文件提供外部子集。 若文件中含有 DOCTYPE 宣告但省略外部子集,則可擴充可用於驗證、實體處理及屬性處理(正規化、預設及報告類型,包括 ID)的宣告。 此擴充透過方法報告 LexicalHandler#startDTD startDTD() ,彷彿文件文本原本包含外部子集;此回調是在報告任何內部子集資料或錯誤之前完成。</p>

此方法也可用於沒有 DOCTYPE 宣告的文件。 當遇到根元素但未見 DOCTYPE 宣告時,會呼叫此方法。 若回傳外部子集的值,該根元素會被宣告為根元素,從而在文件結尾剪接 DOCTYPE 宣告,否則無法有效。 在這種情況下,解析器回調的序列邏輯上類似於:

... comments and PIs from the prolog (as usual)
            startDTD ("rootName", source.getPublicId (), source.getSystemId ());
            startEntity ("[dtd]");
            ... declarations, comments, and PIs from the external subset
            endEntity ("[dtd]");
            endDTD ();
            ... then the rest of the document (as usual)
            startElement (..., "rootName", ...);

請注意,InputSource 不會有進一步的解析度。 此方法的實作可能希望調用以 #resolveEntity resolveEntity() 獲得如使用DTD實體本地快取等好處。 此外,若(非驗證)處理器不包含外部參數實體,此方法絕不會被使用。

此方法的用途包括在與 XML 處理器互通時進行資料驗證,這些處理器總是需要外部實體不希望的網路存取,或因其他原因採用「禁止 DTD」政策。 非驗證的動機包括強制文件包含 DTD,以確保屬性的處理一致。 例如,XPath 處理器需要知道哪些 attibute 具有「ID」型別,才能處理廣泛使用的引用類型。

<強烈>警告:</strong> 返回外部子集會修改輸入文件。 透過提供一般實體的定義,它可以讓格式不佳的文件看起來像是良好形成的。

的 org.xml.sax.ext.EntityResolver2.getExternalSubset(java.lang.String, java.lang.String)Java 檔。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於