ILSParser.ParseWithContext(ILSInput, INode, Int16) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
從所 LSInput 識別的資源剖析 XML 片段,並將內容插入現有檔中,該位置指定 context 了 和 action 自變數。
[Android.Runtime.Register("parseWithContext", "(Lorg/w3c/dom/ls/LSInput;Lorg/w3c/dom/Node;S)Lorg/w3c/dom/Node;", "GetParseWithContext_Lorg_w3c_dom_ls_LSInput_Lorg_w3c_dom_Node_SHandler:Org.W3c.Dom.LS.ILSParserInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.W3c.Dom.INode? ParseWithContext(Org.W3c.Dom.LS.ILSInput? input, Org.W3c.Dom.INode? contextArg, short action);
[<Android.Runtime.Register("parseWithContext", "(Lorg/w3c/dom/ls/LSInput;Lorg/w3c/dom/Node;S)Lorg/w3c/dom/Node;", "GetParseWithContext_Lorg_w3c_dom_ls_LSInput_Lorg_w3c_dom_Node_SHandler:Org.W3c.Dom.LS.ILSParserInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member ParseWithContext : Org.W3c.Dom.LS.ILSInput * Org.W3c.Dom.INode * int16 -> Org.W3c.Dom.INode
參數
- input
- ILSInput
LSInput要從中讀取來源文件的 。 源文檔必須是 XML 片段,亦即除了完整 XML 檔以外的任何專案(除了類型 DOCUMENT_NODE的內容節點為 的情況下,以及動作為 ACTION_REPLACE_CHILDREN)、DOCTYPE (內部子集)、實體宣告(s)、表示法宣告(s)或 XML 或文字宣告(s) 以外的任何專案。
- contextArg
- INode
做為所剖析數據內容的節點。 這個節點必須是 Document 節點、 DocumentFragment 節點或類型節點,且該節點是允許做為節點子 Element 系的節點,例如它不能是 Attribute 節點。
- action
- Int16
此參數描述應該在插入的新節點集與內容節點的現有子系之間採取哪些動作。 上述定義一組可能的動作 ACTION_TYPES 。
傳回
傳回剖析作業結果的節點。 如果結果是一個以上的最上層節點,則會傳回第一個節點。
- 屬性
例外狀況
HIERARCHY_REQUEST_ERR:如果內容無法取代、在內容節點之前、之後插入或做為內容節點的子系,則引發 (另請參閱 Node.insertBefore 或 Node.replaceChild [] 中 )。
NOT_SUPPORTED_ERR:如果 LSParser 不支援此方法,或內容節點的類型 Document 為 ,且 DOM 實作不支援取代 DocumentType 子或 Element 子系,則引發。
NO_MODIFICATION_ALLOWED_ERR:如果內容節點是只讀節點,而且內容會附加至其子清單,或內容節點的父節點是唯讀節點,且內容正在其子清單中插入,則引發。
INVALID_STATE_ERR:如果 LSParser.busy 屬性為 true,則引發。
PARSE_ERR:如果 LSParser 無法載入 XML 片段,則引發 。 如果 DOM 應用程式要取得錯誤的詳細資料,則應使用 參數「 附加 DOMErrorHandler 」 。
備註
從所 LSInput 識別的資源剖析 XML 片段,並將內容插入現有檔中,該位置指定 context 了 和 action 自變數。 剖析輸入數據流時,會根據插入結果的位置,使用內容節點(或其父節點,來解析未系結的命名空間前置詞。 內容節點的 ownerDocument 節點(如果型 DOCUMENT_NODE別的節點為 ,則為節點本身),用來解析預設屬性和實體參考。 <br> 隨著新數據插入檔中,每個內容節點的新立即子系或同層級都會引發至少一個突變事件。 <br> 如果內容節點是節點,且動作為 Document ACTION_REPLACE_CHILDREN,則傳遞為內容節點的檔將會變更,讓其 xmlEncoding、documentURI、、xmlVersioninputEncoding、 xmlStandalone和所有其他這類屬性都設定為使用 LSParser.parse()剖析輸入來源時所設定的 。 <br> 這個方法一律是同步的,即使 LSParser 是異步的 (LSParser.async 為 true)。 <br> 如果在剖析時發生錯誤,呼叫端會透過 ErrorHandler 與 的 “ error-handler” 參數 DOMConfiguration相關聯的實例收到通知。 <br> 呼叫 時parseWithContext,將會忽略下列組態參數的值,而且其預設值一律會改用:“validate”、“validate-if-schema”和 “element-content-whitespace”。 其他參數會正常處理,剖析器預期會呼叫 LSParserFilter ,就像剖析整個文件一樣。
的 org.w3c.dom.ls.LSParser.parseWithContext(org.w3c.dom.ls.LSInput, org.w3c.dom.Node, short)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。