IEntityResolver2.GetExternalSubset(String, String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
允許應用程式為未明確定義的文件提供外部子集。
[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 所創建與分享的作品,並依授權條款所描述的使用進行修改。