ILSParser.ParseWithContext(ILSInput, INode, Int16) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Analise um fragmento XML de um recurso identificado por um LSInput
e insira o conteúdo em um documento existente na posição especificada com os context
argumentos e 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
Parâmetros
- input
- ILSInput
A LSInput
partir do qual o documento de origem deve ser lido. O documento de origem deve ser um fragmento XML, ou seja, qualquer coisa, exceto um documento XML completo (exceto no caso em que o nó de contexto do tipo DOCUMENT_NODE
, e a ação é ACTION_REPLACE_CHILDREN
), um DOCTYPE (subconjunto interno), declaração(ões) de entidade, declaração(ões) de notação ou declaração(ões) XML ou de texto.
- contextArg
- INode
O nó que é usado como o contexto para os dados que estão sendo analisados. Esse nó deve ser um Document
nó, um DocumentFragment
nó ou um nó de um tipo que é permitido como filho de um Element
nó, por exemplo, não pode ser um Attribute
nó.
- action
- Int16
Este parâmetro descreve qual ação deve ser executada entre o novo conjunto de nós que está sendo inserido e os filhos existentes do nó de contexto. O conjunto de ações possíveis é definido acima ACTION_TYPES
.
Retornos
Retorne o nó que é o resultado da operação de análise. Se o resultado for mais de um nó de nível superior, o primeiro será retornado.
- Atributos
Exceções
HIERARCHY_REQUEST_ERR: Gerado se o conteúdo não puder substituir, ser inserido antes, depois ou como filho do nó de contexto (consulte também Node.insertBefore
ou Node.replaceChild
em [] ).
NOT_SUPPORTED_ERR: Gerado se o não oferecer suporte a LSParser
esse método ou se o nó de contexto for do tipo Document
e a implementação do DOM não oferecer suporte à substituição do DocumentType
filho ou Element
filho.
NO_MODIFICATION_ALLOWED_ERR: Gerado se o nó de contexto for um nó somente leitura e o conteúdo estiver sendo anexado à sua lista filho ou se o nó pai do nó de contexto for um nó somente leitura e o conteúdo estiver sendo inserido em sua lista filho.
INVALID_STATE_ERR: Gerado se o LSParser.busy
atributo for true
.
PARSE_ERR: Gerado se o LSParser
não foi possível carregar o fragmento XML. Os aplicativos DOM devem anexar um DOMErrorHandler
usando o parâmetro "" se desejarem obter detalhes sobre o erro.
Comentários
Analise um fragmento XML de um recurso identificado por um LSInput
e insira o conteúdo em um documento existente na posição especificada com os context
argumentos e action
. Ao analisar o fluxo de entrada, o nó de contexto (ou seu pai, dependendo de onde o resultado será inserido) é usado para resolver prefixos de namespace não acoplados. O nó do nó ownerDocument
de contexto (ou o próprio nó se o nó do tipo DOCUMENT_NODE
) é usado para resolver atributos padrão e referências de entidade. <br> À medida que os novos dados são inseridos no documento, pelo menos um evento de mutação é acionado por novo filho imediato ou irmão do nó de contexto. <br> Se o nó de contexto for um Document
nó e a ação for ACTION_REPLACE_CHILDREN
, o documento que for passado como nó de contexto será alterado de tal forma que seu xmlEncoding
, documentURI
, xmlVersion
, inputEncoding
, xmlStandalone
e todos os outros atributos sejam definidos para o que seriam definidos se a fonte de entrada fosse analisada usando LSParser.parse()
. <br> Este método é sempre síncrono, mesmo que o seja assíncrono LSParser
(LSParser.async
é true
). <br> Se ocorrer um erro durante a DOMConfiguration
análise, o chamador será notificado por meio da ErrorHandler
instância associada ao parâmetro " error-handler" do . <br> Ao chamar parseWithContext
, os valores dos seguintes parâmetros de configuração serão ignorados e seus valores padrão sempre serão usados: " validate", " validate-if-schema" e " element-content-whitespace". Outros parâmetros serão tratados normalmente, e espera-se que o analisador chame o LSParserFilter
como se um documento inteiro fosse analisado.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.