IDocument.RenameNode(INode, String, String) Methode

Definition

Benennen Sie einen vorhandenen Knoten vom Typ ELEMENT_NODE oder 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

Parameter

n
INode

Der knoten, der umbenannt werden soll.

namespaceURI
String

Der neue Namespace-URI.

qualifiedName
String

Der neue qualifizierte Name.

Gibt zurück

Der umbenannte Knoten. Dies ist entweder der angegebene Knoten oder der neue Knoten, der erstellt wurde, um den angegebenen Knoten zu ersetzen.

Attribute

Ausnahmen

NOT_SUPPORTED_ERR: Wird ausgelöst, wenn der Typ des angegebenen Knotens weder noch ELEMENT_NODEATTRIBUTE_NODE, oder wenn die Implementierung die Umbenennung des Dokumentelements nicht unterstützt.
INVALID_CHARACTER_ERR: Wird ausgelöst, wenn der neue qualifizierte Name kein XML-Name gemäß der im Document.xmlVersion Attribut angegebenen XML-Version ist.
WRONG_DOCUMENT_ERR: Wird ausgelöst, wenn der angegebene Knoten aus einem anderen Dokument als diesem Dokument erstellt wurde.
NAMESPACE_ERR: Wird ausgelöst, wenn es qualifiedName sich um einen falsch formatierten qualifizierten Namen handelt, wenn das qualifiedName Präfix und das namespaceURI Präfix nullqualifiedName "xml" aufweist und sich von namespaceURI "" [] unterscheidet. Wird auch ausgelöst, wenn der umbenannte Knoten ein Attribut ist, wenn das qualifiedNamePräfix oder das Präfix "xmlns" ist und sich von namespaceURI "" unterscheidet.

Hinweise

Benennen Sie einen vorhandenen Knoten vom Typ ELEMENT_NODE oder ATTRIBUTE_NODE. <Br>Ändert dies nach Möglichkeit einfach den Namen des angegebenen Knotens, andernfalls wird dadurch ein neuer Knoten mit dem angegebenen Namen erstellt und der vorhandene Knoten durch den neuen Knoten ersetzt, wie unten beschrieben. <br>Wenn das einfache Ändern des Namens des angegebenen Knotens nicht möglich ist, werden die folgenden Vorgänge ausgeführt: Ein neuer Knoten wird erstellt, jeder registrierte Ereignislistener wird auf dem neuen Knoten registriert, alle benutzerdaten, die mit dem alten Knoten verbunden sind, werden aus diesem Knoten entfernt, der alte Knoten wird aus dem übergeordneten Knoten entfernt, sofern vorhanden, die untergeordneten Elemente in den neuen Knoten verschoben werden, wenn der umbenannte Knoten ein Element Attribut ist, in den neuen Knoten verschoben wird, wird der neue Knoten an der Position eingefügt, an der der alte Knoten in der untergeordneten Knotenliste des übergeordneten Knotens enthalten ist, sofern er über einen verfügt, die Benutzerdaten, die an den alten Knoten angefügt wurden, an den neuen Knoten angefügt. <br>Wenn der umbenennte Knoten nur Element die angegebenen Attribute verschoben wird, werden standardattribute, die von der DTD stammen, entsprechend dem neuen Elementnamen aktualisiert. Darüber hinaus kann die Implementierung Standardattribute aus anderen Schemas aktualisieren. Anwendungen sollten verwenden Document.normalizeDocument() , um sicherzustellen, dass diese Attribute up-to-date sind. <br>Wenn es sich bei dem umbenennten Knoten um einen Attr Knoten handelt, der mit einem Elementverknüpft ist, wird der Knoten zuerst aus der Element Attributzuordnung entfernt. Nach der Umbenennung wird dann entweder durch Ändern des vorhandenen Knotens oder durch Erstellen eines neuen Knotens wie oben beschrieben ein neuer Knoten zurückgesetzt. <br>, <ul><li> ein Benutzerdatenereignis NODE_RENAMED wird ausgelöst, </li li><>, wenn die Implementierung das Feature "MutationNameEvents" unterstützt, jeder an dieser Methode beteiligte Mutationsvorgang löst das entsprechende Ereignis aus, und am Ende wird das Ereignis {http://www.w3.org/2001/xml-events, DOMElementNameChanged} oder {http://www.w3.org/2001/xml-events, DOMAttributeNameChanged} ausgelöst. </li></ul>

In DOM-Ebene 3 hinzugefügt.

Java Dokumentation für org.w3c.dom.Document.renameNode(org.w3c.dom.Node, java.lang.String, java.lang.String).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: