IEntityResolver2.ResolveEntity(String, String, String, String) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
允許應用程式將外部實體的參考對應至輸入來源，或告訴剖析器應該使用傳統 URI 解析。
[Android.Runtime.Register("resolveEntity", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)Lorg/xml/sax/InputSource;", "GetResolveEntity_Ljava_lang_String_Ljava_lang_String_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? ResolveEntity (string? name, string? publicId, string? baseURI, string? systemId);[<Android.Runtime.Register("resolveEntity", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)Lorg/xml/sax/InputSource;", "GetResolveEntity_Ljava_lang_String_Ljava_lang_String_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 ResolveEntity : string * string * string * string -> Org.Xml.Sax.InputSource參數
- name
- String
識別要解析的外部實體。 外部子集的 “[dtd]” 或開頭為 “%” 的名稱，以表示參數實體，或是一般實體的名稱。 當 SAX2 剖析器叫用時，這絕不是 Null。
- publicId
- String
所參考之外部實體的公用標識碼（如 XML 規格所需正規化），如果沒有提供，則為 null。
- baseURI
- String
相對於哪些相對系統標識碼進行解譯的 URI。 這一定是絕對 URI，除非它是 null（可能是因為 XMLReader 沒有輸入來源）。 此 URI 是由 XML 規格所定義，以做為開始相關宣告之 「<」 相關聯的 URI。
- systemId
- String
所參考之外部實體的系統標識碼;相對或絕對 URI。 SAX2 剖析器叫用時絕不為 Null;只有宣告的實體，以及任何外部子集，都是由這類剖析器解析。
傳回
InputSource 物件，描述剖析器要使用的新輸入來源。 傳回 null 會指示剖析器針對基底 URI 解析系統標識碼，並開啟與結果 URI 的連線。
- 屬性
例外狀況
任何 SAX 例外狀況，可能包裝另一個例外狀況。
可能表示無法建立新的 InputStream 或讀取器，或非法 URL。
備註
允許應用程式將外部實體的參考對應至輸入來源，或告訴剖析器應該使用傳統 URI 解析。 這個方法只會針對已正確宣告的外部實體呼叫。 這個方法提供比 EntityResolver 介面更多的彈性，支援更複雜的目錄配置實作，例如 OASIS XML 目錄規格所定義的目錄配置。</p>
設定為使用此解析程式方法的剖析器會呼叫它，以判斷要用於因 XML 文字中參考而包含之任何外部實體的輸入來源。 會排除文件實體，以及所 #getExternalSubset getExternalSubset()傳回的任何外部實體。 當將 （非驗證） 處理器設定為不使用功能旗標來包含實體類別（參數或一般）時，不會針對這類實體叫用此方法。
請注意，此處使用的實體命名配置與 在 或 org.xml.sax.ContentHandler#skippedEntity ContentHandler.skippedEntity() 方法中使用的LexicalHandler相同。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。