IDocument.RenameNode(INode, String, String) Méthode

Définition

Espace de noms:: Org.W3c.Dom

Assembly:: Mono.Android.dll

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.

Renommez un nœud existant de type ELEMENT_NODE ou ATTRIBUTE_NODE.

[Android.Runtime.Register("renameNode", "(Lorg/w3c/dom/Node;Ljava/lang/String;Ljava/lang/String;)Lorg/w3c/dom/Node;", "GetRenameNode_Lorg_w3c_dom_Node_Ljava_lang_String_Ljava_lang_String_Handler:Org.W3c.Dom.IDocumentInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.W3c.Dom.INode? RenameNode(Org.W3c.Dom.INode? n, string? namespaceURI, string? qualifiedName);

[<Android.Runtime.Register("renameNode", "(Lorg/w3c/dom/Node;Ljava/lang/String;Ljava/lang/String;)Lorg/w3c/dom/Node;", "GetRenameNode_Lorg_w3c_dom_Node_Ljava_lang_String_Ljava_lang_String_Handler:Org.W3c.Dom.IDocumentInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member RenameNode : Org.W3c.Dom.INode * string * string -> Org.W3c.Dom.INode

Paramètres

n: INode

Nœud à renommer.

namespaceURI: String

NOUVEL URI d’espace de noms.

qualifiedName: String

Nouveau nom qualifié.

Retours

INode

Nœud renommé. Il s’agit du nœud spécifié ou du nouveau nœud créé pour remplacer le nœud spécifié.

Attributs: RegisterAttribute

Exceptions

DOMException

NOT_SUPPORTED_ERR : déclenché lorsque le type du nœud spécifié n’est ni ni ELEMENT_NODE ni ATTRIBUTE_NODE, ou si l’implémentation ne prend pas en charge le renommage de l’élément de document.
INVALID_CHARACTER_ERR : déclenché si le nouveau nom qualifié n’est pas un nom XML conformément à la version XML utilisée dans l’attribut Document.xmlVersion .
WRONG_DOCUMENT_ERR : déclenché lorsque le nœud spécifié a été créé à partir d’un document différent de celui de ce document.
NAMESPACE_ERR : déclenché si le qualifiedName nom qualifié est incorrect, s’il qualifiedName a un préfixe et le namespaceURI préfixe est , ou si le null préfixe est « xml » et que celui-ci qualifiedName est namespaceURIdifférent de « » [] . Également déclenché, lorsque le nœud renommé est un attribut, si le préfixe ou le qualifiedNamepréfixe est « xmlns » et est namespaceURI différent de « ».

Remarques

Renommez un nœud existant de type ELEMENT_NODE ou ATTRIBUTE_NODE. Si possible, cela modifie simplement le nom du nœud donné, sinon cela crée un nouveau nœud avec le nom spécifié et remplace le nœud existant par le nouveau nœud, comme décrit ci-dessous. Si la modification du nom du nœud donné n’est pas possible, les opérations suivantes sont effectuées : un nouveau nœud est créé, tout écouteur d’événement inscrit sur le nouveau nœud, toutes les données utilisateur attachées à l’ancien nœud sont supprimées de ce nœud, l’ancien nœud est supprimé de son parent s’il en a un, les enfants sont déplacés vers le nouveau nœud, si le nœud renommé est un Element attribut est déplacé vers le nouveau nœud, le nouveau nœud est inséré à la position que l’ancien nœud utilisé pour avoir dans la liste des nœuds enfants de son parent s’il en a un, les données utilisateur attachées à l’ancien nœud sont attachées au nouveau nœud. Lorsque le nœud renommé est un Element seul attribut spécifié est déplacé, les attributs par défaut proviennent de la DTD sont mis à jour en fonction du nouveau nom d’élément. En outre, l’implémentation peut mettre à jour les attributs par défaut à partir d’autres schémas. Les applications doivent utiliser Document.normalizeDocument() pour garantir que ces attributs sont up-to-date. Lorsque le nœud renommé est un nœud Attr attaché à un Elementnœud, le nœud est d’abord supprimé du Element mappage d’attributs. Ensuite, une fois renommé, soit en modifiant le nœud existant, soit en créant un nouveau nœud comme décrit ci-dessus, il est remis en arrière. En outre, <ul><li> un événement NODE_RENAMED de données utilisateur est déclenché, </li><> lorsque l’implémentation prend en charge la fonctionnalité « MutationNameEvents », chaque opération de mutation impliquée dans cette méthode déclenche l’événement approprié, et à la fin l’événement {http://www.w3.org/2001/xml-events, DOMElementNameChanged} ou {http://www.w3.org/2001/xml-events, DOMAttributeNameChanged} est déclenché. </li></ul>

Ajouté au niveau DOM 3.

Java documentation pour org.w3c.dom.Document.renameNode(org.w3c.dom.Node, java.lang.String, java.lang.String).

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.

S’applique à