IDocument.ImportNode(INode, Boolean) 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.
Importe un nœud d’un autre document vers ce document, sans modifier ou supprimer le nœud source du document d’origine ; cette méthode crée une nouvelle copie du nœud source.
[Android.Runtime.Register("importNode", "(Lorg/w3c/dom/Node;Z)Lorg/w3c/dom/Node;", "GetImportNode_Lorg_w3c_dom_Node_ZHandler:Org.W3c.Dom.IDocumentInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.W3c.Dom.INode? ImportNode(Org.W3c.Dom.INode? importedNode, bool deep);
[<Android.Runtime.Register("importNode", "(Lorg/w3c/dom/Node;Z)Lorg/w3c/dom/Node;", "GetImportNode_Lorg_w3c_dom_Node_ZHandler:Org.W3c.Dom.IDocumentInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member ImportNode : Org.W3c.Dom.INode * bool -> Org.W3c.Dom.INode
Paramètres
- importedNode
- INode
Nœud à importer.
- deep
- Boolean
Si true, importez de manière récursive la sous-arborescence sous le nœud spécifié ; si false, importez uniquement le nœud lui-même, comme expliqué ci-dessus. Cela n’a aucun effet sur les nœuds qui ne peuvent pas avoir d’enfants, et sur , et Attr sur EntityReferenceles nœuds.
Retours
Nœud importé qui appartient à ce Documentfichier .
- Attributs
Exceptions
NOT_SUPPORTED_ERR : déclenché si le type de nœud importé n’est pas pris en charge.
INVALID_CHARACTER_ERR : déclenché si l’un des noms importés n’est pas un nom XML conformément à la version XML utilisée dans l’attribut Document.xmlVersion . Cela peut se produire lors de l’importation d’un élément XML 1.1 [] dans un document XML 1.0, par exemple.
Remarques
Importe un nœud d’un autre document vers ce document, sans modifier ou supprimer le nœud source du document d’origine ; cette méthode crée une nouvelle copie du nœud source. Le nœud retourné n’a pas de parent ; (parentNode est null).
<br>Pour tous les nœuds, l’importation d’un nœud crée un objet de nœud appartenant au document d’importation, avec des valeurs d’attribut identiques à celles du nodeName nœud source, nodeTypeainsi que les attributs liés aux espaces de noms (prefix, localNameet namespaceURI). Comme dans l’opération cloneNode , le nœud source n’est pas modifié. Les données utilisateur associées au nœud importé ne sont pas transmises. Toutefois, si un UserDataHandlers élément a été spécifié avec les données associées, ces gestionnaires sont appelés avec les paramètres appropriés avant que cette méthode ne retourne.
<br>Informations supplémentaires sont copiées selon les besoins de l’objet nodeType, en tentant de mettre en miroir le comportement attendu si un fragment de source XML ou HTML a été copié d’un document à un autre, reconnaissant que les deux documents peuvent avoir des DTD différents dans le cas XML. La liste suivante décrit les spécificités de chaque type de nœud.
<dl><dt ATTRIBUTE_NODE>/dt<><dd>L’attribut ownerElement est défini null sur et l’indicateur specified est défini true sur le fichier généré Attr. Les descendants de la source Attr sont importés de manière récursive et les nœuds résultants sont réassembtés pour former la sous-arborescence correspondante. Notez que le deep paramètre n’a aucun effet sur Attr les nœuds ; ils transportent toujours leurs enfants avec eux lorsqu’ils sont importés.</dd><dt DOCUMENT_FRAGMENT_NODE>/dt<><dd>Si l’option deep a été définie truesur , les descendants de la source DocumentFragment sont importés de manière récursive et les nœuds résultants réassemblent sous l’objet importé DocumentFragment pour former la sous-arborescence correspondante. Sinon, cela génère simplement un vide DocumentFragment.<Les nœuds /dd><dt>DOCUMENT_NODE</dt dd><>Document ne peuvent pas être importés.<Les nœuds /dd><dt>DOCUMENT_TYPE_NODE</dt dd><>DocumentType ne peuvent pas être importés.</dd><dt ELEMENT_NODE>/dt<dt><><em>, les nœuds d’attributs spécifiés</em> de l’élément source sont importés et les nœuds générés Attr sont attachés à l’attribut généréElement. Les attributs par défaut ne sont <>pas</em> copiés, bien que si le document importé dans définit des attributs par défaut pour ce nom d’élément, ceux-ci sont attribués. Si le importNodedeep paramètre a été défini truesur , les descendants de l’élément source sont récursivement importés et les nœuds résultants réassemblaient pour former la sous-arborescence correspondante.</dd><dt>ENTITY_NODE</dt><dd>Entity nœuds peuvent être importés, mais dans la version actuelle du DOM, il DocumentType est en lecture seule. La possibilité d’ajouter ces nœuds importés à une DocumentType version ultérieure du DOM sera prise en compte. Lors de l’importation, les attributs et publicId les systemIdnotationNameattributs sont copiés. Si une deep importation est demandée, les descendants de la source Entity sont récursivement importés et les nœuds résultants sont réassembtés pour former la sous-arborescence correspondante.</dd><dt ENTITY_REFERENCE_NODE>/dt< dt><dd>uniquement la EntityReference copie elle-même, même si une deep importation est demandée, car les documents source et de destination peuvent avoir défini l’entité différemment. Si le document importé dans fournit une définition pour ce nom d’entité, sa valeur est affectée.</dd><dt>NOTATION_NODE</dt><dd>Notation nœuds peuvent être importés, mais dans la version actuelle du DOM, il DocumentType est en lecture seule. La possibilité d’ajouter ces nœuds importés à une DocumentType version ultérieure du DOM sera prise en compte. Lors de l’importation, les publicId attributs et systemId les attributs sont copiés. Notez que le deep paramètre n’a aucun effet sur ce type de nœuds, car il ne peut pas avoir d’enfants.</dd><dt> PROCESSING_INSTRUCTION_NODE</dt dd><>Le nœud importé copie ses target valeurs à data partir de ceux du nœud source. Notez que le deep paramètre n’a aucun effet sur ce type de nœuds, car il ne peut pas avoir d’enfants.</dd><dt>TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE</dt dt><dd dd>Ces trois types de nœuds héritent de CharacterData la copie de leurs data attributs et length de ceux du nœud source. Notez que le deep paramètre n’a aucun effet sur ces types de nœuds, car ils ne peuvent pas avoir d’enfants.</dd></dl>
Ajouté au niveau DOM 2.
Java documentation pour org.w3c.dom.Document.importNode(org.w3c.dom.Node, boolean).
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.