ILSParser.ParseWithContext(ILSInput, INode, Int16) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Analysez un fragment XML d’une ressource identifiée par un LSInput
contenu et insérez le contenu dans un document existant à la position spécifiée avec les arguments et action
les context
arguments.
[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
Paramètres
- input
- ILSInput
LSInput
À partir duquel le document source doit être lu. Le document source doit être un fragment XML, c’est-à-dire tout sauf un document XML complet (sauf dans le cas où le nœud de contexte de type DOCUMENT_NODE
, et l’action est ACTION_REPLACE_CHILDREN
), un DOCTYPE (sous-ensemble interne), des déclarations d’entité, des déclarations de notation ou XML ou des déclarations de texte.
- contextArg
- INode
Nœud utilisé comme contexte pour les données analysées. Ce nœud doit être un Document
nœud, un DocumentFragment
nœud ou un nœud d’un type autorisé en tant qu’enfant d’un Element
nœud, par exemple, il ne peut pas être un Attribute
nœud.
- action
- Int16
Ce paramètre décrit quelle action doit être effectuée entre le nouvel ensemble de nœuds insérés et les enfants existants du nœud de contexte. L’ensemble des actions possibles est défini ci-dessus ACTION_TYPES
.
Retours
Retourne le nœud qui est le résultat de l’opération d’analyse. Si le résultat est plusieurs nœuds de niveau supérieur, le premier est retourné.
- Attributs
Exceptions
HIERARCHY_REQUEST_ERR : déclenché si le contenu ne peut pas remplacer, être inséré avant, après ou en tant qu’enfant du nœud de contexte (voir également Node.insertBefore
ou Node.replaceChild
dans [] ).
NOT_SUPPORTED_ERR : déclenché si la LSParser
méthode ne prend pas en charge cette méthode, ou si le nœud de contexte est de type Document
et que l’implémentation DOM ne prend pas en charge le remplacement de l’enfant ou Element
de l’enfantDocumentType
.
NO_MODIFICATION_ALLOWED_ERR : déclenché si le nœud de contexte est un nœud en lecture seule et que le contenu est ajouté à sa liste enfant, ou si le nœud parent du nœud de contexte est le nœud en lecture seule et que le contenu est inséré dans sa liste enfant.
INVALID_STATE_ERR : déclenché si l’attribut LSParser.busy
est true
.
PARSE_ERR : déclenché si le LSParser
fragment XML n’a pas pu être chargé. Les applications DOM doivent attacher un DOMErrorHandler
paramètre « » à l’aide du paramètre s’ils souhaitent obtenir des détails sur l’erreur.
Remarques
Analysez un fragment XML d’une ressource identifiée par un LSInput
contenu et insérez le contenu dans un document existant à la position spécifiée avec les arguments et action
les context
arguments. Lors de l’analyse du flux d’entrée, le nœud de contexte (ou son parent, selon l’emplacement où le résultat sera inséré) est utilisé pour résoudre les préfixes d’espace de noms non liés. Le nœud du ownerDocument
contexte (ou le nœud lui-même si le nœud de type DOCUMENT_NODE
) est utilisé pour résoudre les attributs par défaut et les références d’entité. <br> Lorsque les nouvelles données sont insérées dans le document, au moins un événement de mutation est déclenché par nouveau enfant ou frère immédiat du nœud de contexte. <br> Si le nœud de contexte est un Document
nœud et que l’action est ACTION_REPLACE_CHILDREN
, le document transmis en tant que nœud de contexte sera modifié de telle sorte que ses xmlEncoding
attributs , , documentURI
xmlVersion
, inputEncoding
xmlStandalone
et tous les autres attributs de ce type sont définis sur ce qu’ils seraient définis si la source d’entrée a été analysée à l’aide LSParser.parse()
. <br> Cette méthode est toujours synchrone, même si elle LSParser
est asynchrone (LSParser.async
est true
). <br> Si une erreur se produit lors de l’analyse, l’appelant est averti via l’instance ErrorHandler
associée au paramètre « error-handler » du DOMConfiguration
. <br> Lors de l’appel parseWithContext
, les valeurs des paramètres de configuration suivants sont ignorées et leurs valeurs par défaut sont toujours utilisées à la place : « validate », « validate-if-schema » et « element-content-whitespace ». D’autres paramètres seront traités normalement, et l’analyseur est censé appeler le LSParserFilter
tout comme si un document entier a été analysé.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.