ILSParser.ParseWithContext(ILSInput, INode, Int16) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Analice un fragmento XML de un recurso identificado por LSInput
e inserte el contenido en un documento existente en la posición especificada con los context
argumentos y 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
desde LSInput
el que se va a leer el documento de origen. El documento de origen debe ser un fragmento XML, es decir, cualquier cosa excepto un documento XML completo (excepto en el caso de que el nodo de contexto de tipo DOCUMENT_NODE
y la acción sea ACTION_REPLACE_CHILDREN
), un DOCTYPE (subconjunto interno), declaraciones de entidad, declaraciones de notación o declaraciones xml o de texto.
- contextArg
- INode
Nodo que se usa como contexto para los datos que se analizan. Este nodo debe ser un Document
nodo, un DocumentFragment
nodo o un nodo de un tipo que se permite como elemento secundario de un Element
nodo, por ejemplo, no puede ser un Attribute
nodo.
- action
- Int16
Este parámetro describe qué acción se debe realizar entre el nuevo conjunto de nodos que se insertan y los elementos secundarios existentes del nodo de contexto. El conjunto de acciones posibles se define en ACTION_TYPES
lo anterior.
Devoluciones
Devuelve el nodo que es el resultado de la operación de análisis. Si el resultado es más de un nodo de nivel superior, se devuelve el primero.
- Atributos
Excepciones
HIERARCHY_REQUEST_ERR: se genera si el contenido no se puede reemplazar, se inserta antes, después o como elemento secundario del nodo de contexto (vea también Node.insertBefore
o Node.replaceChild
en [] ).
NOT_SUPPORTED_ERR: se genera si LSParser
no admite este método o si el nodo de contexto es de tipo Document
y la implementación dom no admite el reemplazo del DocumentType
elemento secundario o Element
secundario.
NO_MODIFICATION_ALLOWED_ERR: se genera si el nodo de contexto es un nodo de solo lectura y el contenido se anexa a su lista secundaria, o si el nodo primario del nodo de contexto es de solo lectura y el contenido se inserta en su lista secundaria.
INVALID_STATE_ERR: se genera si el LSParser.busy
atributo es true
.
PARSE_ERR: se genera si no LSParser
se pudo cargar el fragmento XML. Las aplicaciones DOM deben adjuntar un DOMErrorHandler
mediante el parámetro "" si desean obtener detalles sobre el error.
Comentarios
Analice un fragmento XML de un recurso identificado por LSInput
e inserte el contenido en un documento existente en la posición especificada con los context
argumentos y action
. Al analizar el flujo de entrada, se usa el nodo de contexto (o su elemento primario, dependiendo de dónde se insertará el resultado) para resolver prefijos de espacio de nombres no enlazados. El nodo del ownerDocument
nodo de contexto (o el propio nodo si el nodo de tipo DOCUMENT_NODE
) se usa para resolver atributos y referencias de entidad predeterminados. <br> A medida que se insertan los nuevos datos en el documento, se desencadena al menos un evento de mutación por nuevo elemento secundario inmediato o relacionado del nodo de contexto. <br> Si el nodo de contexto es un Document
nodo y la acción es ACTION_REPLACE_CHILDREN
, el documento que se pasa como nodo de contexto se cambiará de modo que sus xmlEncoding
atributos , documentURI
, xmlVersion
, inputEncoding
xmlStandalone
y todos los demás atributos de este tipo se establecen en lo que se establecerían en si el origen de entrada se analizase mediante LSParser.parse()
. <br> Este método siempre es sincrónico, incluso si es LSParser
asincrónico (LSParser.async
es true
). <br> Si se produce un error al analizar, se notifica al autor de la llamada a través de la ErrorHandler
instancia asociada al parámetro "error-handler" de .DOMConfiguration
<br> Al llamar a parseWithContext
, los valores de los siguientes parámetros de configuración se omitirán y sus valores predeterminados siempre se usarán en su lugar: " validate", " validate-if-schema" y " element-content-whitespace". Otros parámetros se tratarán normalmente y se espera que el analizador llame LSParserFilter
al igual que si se analiza un documento completo.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.