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

Definición

Espacio de nombres:: Org.W3c.Dom

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Cambie el nombre de un nodo existente de tipo ELEMENT_NODE o 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

Parámetros

n: INode

Nodo al que se va a cambiar el nombre.

namespaceURI: String

Nuevo URI de espacio de nombres.

qualifiedName: String

Nuevo nombre completo.

Devoluciones

INode

Nodo cuyo nombre ha cambiado. Este es el nodo especificado o el nuevo nodo que se creó para reemplazar el nodo especificado.

Atributos: RegisterAttribute

Excepciones

DOMException

NOT_SUPPORTED_ERR: se genera cuando el tipo del nodo especificado no ELEMENT_NODE es ni ATTRIBUTE_NODE, o si la implementación no admite el cambio de nombre del elemento de documento.
INVALID_CHARACTER_ERR: se genera si el nuevo nombre completo no es un nombre XML según la versión XML en uso especificada en el Document.xmlVersion atributo .
WRONG_DOCUMENT_ERR: se genera cuando se creó el nodo especificado a partir de un documento diferente al de este documento.
NAMESPACE_ERR: se genera si qualifiedName es un nombre completo con formato incorrecto, si qualifiedName tiene un prefijo y namespaceURI es null, o si qualifiedName tiene un prefijo que es "xml" y es namespaceURI diferente de "" [] . También se genera, cuando se cambia el nombre del nodo es un atributo, si el qualifiedName, o su prefijo, es "xmlns" y es namespaceURI diferente de "".

Comentarios

Cambie el nombre de un nodo existente de tipo ELEMENT_NODE o ATTRIBUTE_NODE. Cuando sea posible, simplemente cambia el nombre del nodo especificado; de lo contrario, esto crea un nuevo nodo con el nombre especificado y reemplaza el nodo existente por el nuevo nodo, tal como se describe a continuación. Si simplemente no es posible cambiar el nombre del nodo especificado, se realizan las siguientes operaciones: se crea un nuevo nodo, se registra cualquier agente de escucha de eventos registrados en el nuevo nodo, los datos de usuario adjuntos al nodo antiguo se quitan de ese nodo, el nodo antiguo se quita de su primario si tiene uno, los elementos secundarios se mueven al nuevo nodo, si el nodo cuyo nombre ha cambiado es un Element atributo se mueve al nuevo nodo, el nuevo nodo se inserta en la posición que el nodo anterior se usa para tener en la lista de nodos secundarios de su elemento primario si tiene uno, los datos de usuario que se adjuntaron al nodo antiguo se adjuntan al nuevo nodo. Cuando se cambia el nombre del nodo es un Element solo se mueven los atributos especificados, los atributos predeterminados que se originan en el DTD se actualizan según el nuevo nombre del elemento. Además, la implementación puede actualizar los atributos predeterminados de otros esquemas. Las aplicaciones deben usar Document.normalizeDocument() para garantizar que estos atributos se up-to-date. Cuando se cambia el nombre del nodo es un Attr que está asociado a , Elementel nodo se quita primero de la Element asignación de atributos. A continuación, una vez cambiado el nombre, ya sea modificando el nodo existente o creando uno nuevo como se ha descrito anteriormente, se vuelve a colocar. Además, <ul><li> se desencadena un evento NODE_RENAMED de datos de usuario, </li><li> cuando la implementación admite la característica "MutationNameEvents", cada operación de mutación implicada en este método desencadena el evento adecuado y, al final, se desencadena el evento {http://www.w3.org/2001/xml-events, DOMElementNameChanged} o {http://www.w3.org/2001/xml-events, DOMAttributeNameChanged} . </li></ul>

Agregado en DOM Level 3.

Java documentación para org.w3c.dom.Document.renameNode(org.w3c.dom.Node, java.lang.String, java.lang.String).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a