IDocument.RenameNode(INode, String, String) Metodo

Definizione

Spazio dei nomi:: Org.W3c.Dom

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rinominare un nodo esistente di 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

Parametri

n: INode

Nodo da rinominare.

namespaceURI: String

Nuovo URI dello spazio dei nomi.

qualifiedName: String

Nuovo nome completo.

Valori restituiti

INode

Nodo rinominato. Si tratta del nodo specificato o del nuovo nodo creato per sostituire il nodo specificato.

Attributi: RegisterAttribute

Eccezioni

DOMException

NOT_SUPPORTED_ERR: generato quando il tipo del nodo specificato non ELEMENT_NODE è né né ATTRIBUTE_NODEo se l'implementazione non supporta la ridenominazione dell'elemento del documento.
INVALID_CHARACTER_ERR: generato se il nuovo nome completo non è un nome XML in base alla versione XML in uso specificata nell'attributo Document.xmlVersion .
WRONG_DOCUMENT_ERR: generato quando il nodo specificato è stato creato da un documento diverso da questo documento.
NAMESPACE_ERR: generato se qualifiedName è un nome qualificato in formato non valido, se ha qualifiedName un prefisso e namespaceURI è nulloppure se qualifiedName ha un prefisso "xml" e l'oggetto namespaceURI è diverso da "" [] . Generato anche, quando il nodo rinominato è un attributo, se il qualifiedNameprefisso , o il relativo prefisso, è "xmlns" e l'oggetto namespaceURI è diverso da "".

Commenti

Rinominare un nodo esistente di tipo ELEMENT_NODE o ATTRIBUTE_NODE. Quando possibile, questo cambia semplicemente il nome del nodo specificato, in caso contrario crea un nuovo nodo con il nome specificato e sostituisce il nodo esistente con il nuovo nodo, come descritto di seguito. Se non è possibile modificare semplicemente il nome del nodo specificato, vengono eseguite le operazioni seguenti: viene creato un nuovo nodo, qualsiasi listener di eventi registrato viene registrato nel nuovo nodo, tutti i dati utente collegati al nodo precedente vengono rimossi da tale nodo, il nodo precedente viene rimosso dal relativo nodo padre, se presente, Gli elementi figlio vengono spostati nel nuovo nodo, se il nodo rinominato è uno Element dei relativi attributi vengono spostati nel nuovo nodo, il nuovo nodo viene inserito nella posizione del nodo precedente usato per avere nell'elenco dei nodi figlio del padre, se presente, i dati utente collegati al nodo precedente vengono collegati al nuovo nodo. Quando il nodo rinominato è un Element solo gli attributi specificati vengono spostati, gli attributi predefiniti originati dal DTD vengono aggiornati in base al nome del nuovo elemento. Inoltre, l'implementazione può aggiornare gli attributi predefiniti da altri schemi. Le applicazioni devono usare Document.normalizeDocument() per garantire che questi attributi siano up-to-date. Quando il nodo rinominato è un oggetto Attr collegato a un Elementoggetto , il nodo viene prima rimosso dalla Element mappa degli attributi. Quindi, una volta rinominato, modificando il nodo esistente o creando un nuovo nodo come descritto in precedenza, viene riportato di nuovo. Inoltre, <ul><li> un evento NODE_RENAMED di dati utente viene generato, </li><li> quando l'implementazione supporta la funzionalità "MutationNameEvents", ogni operazione di mutazione coinvolta in questo metodo attiva l'evento appropriato e alla fine viene generato l'evento {http://www.w3.org/2001/xml-events, DOMElementNameChanged} o {http://www.w3.org/2001/xml-events, DOMAttributeNameChanged} . </li></ul>

Aggiunta in DOM Livello 3.

per org.w3c.dom.Document.renameNode(org.w3c.dom.Node, java.lang.String, java.lang.String).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a