ILSParser.ParseWithContext(ILSInput, INode, Int16) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Analizzare un frammento XML da una risorsa identificata da un LSInput
oggetto e inserire il contenuto in un documento esistente nella posizione specificata con gli context
argomenti 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
Parametri
- input
- ILSInput
Oggetto LSInput
da cui leggere il documento di origine. Il documento di origine deve essere un frammento XML, ad esempio qualsiasi elemento tranne un documento XML completo (tranne nel caso in cui il nodo di contesto di tipo DOCUMENT_NODE
e l'azione sia ACTION_REPLACE_CHILDREN
), un DOCTYPE (subset interno), dichiarazioni di entità, dichiarazioni di notazione o dichiarazioni XML o di testo.
- contextArg
- INode
Nodo usato come contesto per i dati da analizzare. Questo nodo deve essere un Document
nodo, un DocumentFragment
nodo o un nodo di un tipo consentito come figlio di un Element
nodo, ad esempio non può essere un Attribute
nodo.
- action
- Int16
Questo parametro descrive l'azione da eseguire tra il nuovo set di nodi inseriti e gli elementi figlio esistenti del nodo di contesto. Il set di possibili azioni è definito in ACTION_TYPES
precedenza.
Restituisce
Restituisce il nodo che rappresenta il risultato dell'operazione di analisi. Se il risultato è più di un nodo di primo livello, viene restituito il primo.
- Attributi
Eccezioni
HIERARCHY_REQUEST_ERR: generato se il contenuto non può sostituire, essere inserito prima, dopo o come figlio del nodo di contesto (vedere anche Node.insertBefore
o Node.replaceChild
in [] ).
NOT_SUPPORTED_ERR: generato se LSParser
non supporta questo metodo o se il nodo di contesto è di tipo Document
e l'implementazione DOM non supporta la sostituzione dell'elemento DocumentType
figlio o Element
figlio.
NO_MODIFICATION_ALLOWED_ERR: generato se il nodo di contesto è un nodo di sola lettura e il contenuto viene aggiunto all'elenco figlio oppure se il nodo padre del nodo di contesto è di sola lettura e il contenuto viene inserito nell'elenco figlio.
INVALID_STATE_ERR: generato se l'attributo LSParser.busy
è true
.
PARSE_ERR: generato se non LSParser
è stato possibile caricare il frammento XML. Le applicazioni DOM devono allegare un DOMErrorHandler
oggetto usando il parametro "" se desiderano ottenere i dettagli sull'errore.
Commenti
Analizzare un frammento XML da una risorsa identificata da un LSInput
oggetto e inserire il contenuto in un documento esistente nella posizione specificata con gli context
argomenti e action
. Quando si analizza il flusso di input, viene usato il nodo di contesto (o il relativo elemento padre, a seconda della posizione in cui verrà inserito il risultato) per risolvere i prefissi dello spazio dei nomi non associati. Il nodo del nodo di ownerDocument
contesto (o il nodo stesso se il nodo di tipo DOCUMENT_NODE
) viene usato per risolvere gli attributi predefiniti e i riferimenti all'entità. <br> Man mano che i nuovi dati vengono inseriti nel documento, almeno un evento di mutazione viene generato per ogni nuovo figlio immediato o elemento di pari livello del nodo di contesto. <br> Se il nodo di contesto è un Document
nodo e l'azione è ACTION_REPLACE_CHILDREN
, il documento passato come nodo di contesto verrà modificato in modo che il relativo xmlEncoding
documentURI
xmlVersion
, , inputEncoding
, , xmlStandalone
e tutti gli altri attributi di questo tipo siano impostati su ciò che verrebbero impostati su se l'origine di input è stata analizzata usando .LSParser.parse()
<br> Questo metodo è sempre sincrono, anche se LSParser
è asincrono (LSParser.async
è true
). <br> Se si verifica un errore durante l'analisi, il chiamante riceve una notifica tramite l'istanza ErrorHandler
associata al parametro " error-handler" dell'oggetto DOMConfiguration
. <br> Quando si chiama parseWithContext
, i valori dei parametri di configurazione seguenti verranno ignorati e i relativi valori predefiniti verranno sempre usati: " validate", " validate-if-schema" e " element-content-whitespace". Gli altri parametri verranno trattati normalmente e il parser dovrebbe chiamare LSParserFilter
come se fosse stato analizzato un intero documento.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.