IDocument.AdoptNode(INode) Méthode

[Android.Runtime.Register("adoptNode", "(Lorg/w3c/dom/Node;)Lorg/w3c/dom/Node;", "GetAdoptNode_Lorg_w3c_dom_Node_Handler:Org.W3c.Dom.IDocumentInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.W3c.Dom.INode? AdoptNode(Org.W3c.Dom.INode? source);

[<Android.Runtime.Register("adoptNode", "(Lorg/w3c/dom/Node;)Lorg/w3c/dom/Node;", "GetAdoptNode_Lorg_w3c_dom_Node_Handler:Org.W3c.Dom.IDocumentInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member AdoptNode : Org.W3c.Dom.INode -> Org.W3c.Dom.INode

Paramètres

Retours

Nœud adopté, ou null en cas d’échec de cette opération, par exemple lorsque le nœud source provient d’une implémentation différente.

Attributs

RegisterAttribute

Exceptions

Remarques

Tente d’adopter un nœud d’un autre document vers ce document. Si elle est prise en charge, elle modifie le ownerDocument nœud source, ses enfants, ainsi que les nœuds d’attribut attachés s’il y en a un. Si le nœud source a un parent, il est d’abord supprimé de la liste enfant de son parent. Cela permet de déplacer efficacement une sous-arborescence d’un document vers un autre (contrairement importNode() à la création d’une copie du nœud source au lieu de le déplacer). En cas d’échec, les applications doivent utiliser Document.importNode() à la place. Notez que si le nœud adopté fait déjà partie de ce document (c’est-à-dire que le document source et cible sont identiques), cette méthode a toujours l’effet de supprimer le nœud source de la liste enfant de son parent, le cas échéant. 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 et l’indicateur specified est défini true sur le paramètre adoptéAttr. Les descendants de la source Attr sont adoptés de manière récursive.</dd><dt DOCUMENT_FRAGMENT_NODE>/dt<dd><>Les descendants du nœud source sont adoptés de manière récursive.<Les nœuds /dd><dt>DOCUMENT_NODE</dt dd><>Document ne peuvent pas être adoptés.<Les nœuds /dd><dt>DOCUMENT_TYPE_NODE</dt dd><>DocumentType ne peuvent pas être adoptés.<Les nœuds d’attribut /dd><dt>ELEMENT_NODE</dt dd><><em>Spécifié</em> de l’élément source sont adoptés. Les attributs par défaut sont ignorés, bien que si le document adopté dans définit des attributs par défaut pour ce nom d’élément, ceux-ci sont affectés. Les descendants de l’élément source sont adoptés de manière récursive.<Les nœuds /dd><dt>ENTITY_NODE</dt dd><>Entity ne peuvent pas être adoptés.</dd><dt>ENTITY_REFERENCE_NODE</dt dd><dd>Uniquement le EntityReference nœud lui-même est adopté, les descendants sont ignorés, 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.<Les nœuds /dd><dt>NOTATION_NODE</dt dd><>Notation ne peuvent pas être adoptés.</dd><dt>PROCESSING_INSTRUCTION_NODE, TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE</dt dt><dd>Ces nœuds peuvent tous être adoptés. Aucune spécificité.</dd></dl>

<b>Remarque :</b> Étant donné qu’elle ne crée pas de nœuds contrairement à la Document.importNode() méthode, cette méthode ne génère pas d’exception INVALID_CHARACTER_ERR , et les applications doivent utiliser la Document.normalizeDocument() méthode pour vérifier si un nom importé n’est pas un nom XML en fonction de la version XML utilisée.

Ajouté au niveau DOM 3.

Java documentation pour org.w3c.dom.Document.adoptNode(org.w3c.dom.Node).

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.