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：如果属性为 true.，则LSParser.busy引发 。
PARSE_ERR：如果无法加载 XML 片段， LSParser 则引发。 如果 DOM 应用程序想要获取有关错误的详细信息，则应附加 DOMErrorHandler 使用参数“”的 DOM 应用程序。
注解
分析由资源标识 LSInput 的 XML 片段，并将内容插入到现有文档中，该文档位于使用 context 和 action 参数指定的位置。 分析输入流时，上下文节点（或其父节点（具体取决于插入结果的位置）用于解析未绑定的命名空间前缀。 上下文节点的 ownerDocument 节点（或类型 DOCUMENT_NODE节点本身）用于解析默认属性和实体引用。 <br> 在文档中插入新数据时，每个上下文节点的新即时子节点或同级都会触发至少一个突变事件。 <br> 如果上下文节点是节点 Document 并且操作是 ACTION_REPLACE_CHILDREN，则作为上下文节点传递的文档将被更改，以便其 xmlEncoding、 documentURI、 xmlVersion、 inputEncoding、 xmlStandalone和所有其他此类属性设置为使用 LSParser.parse()输入源分析时将设置为它们。 <br> 此方法始终是同步的，即使是异步的 LSParser （LSParser.async 是 true）。 <br> 如果在分析时发生错误，则调用方将通过ErrorHandler与 的DOMConfiguration“error-handler”参数关联的实例通知调用方。 <调用>parseWithContext时，将忽略以下配置参数的值，其默认值将始终改用：“validate”、“validate-if-schema”和“element-content-whitespace”。 其他参数将正常处理，分析器应调用 LSParserFilter 就像分析整个文档一样。
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。