語言

IDocument.RenameNode(INode, String, String) 方法

定義

命名空間:
Org.W3c.Dom
組件:
Mono.Android.dll

將現有的節點ELEMENT_NODEATTRIBUTE_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

參數

n
INode

要重新命名的節點。

namespaceURI
String

新的命名空間 URI。

qualifiedName
String

新的合格名稱。

傳回

INode

重新命名的節點。 這要麼是指定的節點，要麼是新建立的替換該節點。

屬性
RegisterAttribute

例外狀況

DOMException

NOT_SUPPORTED_ERR：當指定節點的型別既非 也不是 ELEMENT_NODE ， ATTRIBUTE_NODE或實作不支援文件元素的重新命名時，會被提出。
INVALID_CHARACTER_ERR：若新限定名稱並非屬性中指定的 Document.xmlVersion XML 版本所用的 XML 名稱，則會被提出。
WRONG_DOCUMENT_ERR：當指定節點是從與本文件不同的文件建立時，會被提出。
NAMESPACE_ERR：若 為 qualifiedName 格式錯誤的合格名稱，或 qualifiedName 有前綴且 namespaceURI 是 null，或 qualifiedName 有前綴為「xml」且與 namespaceURI 「」不同時，則會被提出。 同樣地，當被重新命名的節點是屬性時，若 qualifiedName或其前綴為「xmlns」且 與 namespaceURI 「」不同，

備註

將現有的節點ELEMENT_NODEATTRIBUTE_NODE命名為 或 。 <br>在可能的情況下，只需更改該節點的名稱，否則會建立一個指定名稱的新節點，並如下所述將現有節點替換為新節點。 <br>如果無法簡單更改給定節點的名稱，則執行以下操作：建立新節點，任何註冊的事件監聽器在新節點註冊，舊節點上的所有使用者資料從該節點移除，舊節點若有父節點則從中移除， 子節點會被移到新節點，如果重新命名的節點是 ， Element 其屬性會移到新節點，新節點會插入舊節點在父節點清單中原本的位置，如果舊節點有子節點，原本附加到舊節點的使用者資料會被附加到新節點。 <br>當被重新命名的節點是 且 Element 時，僅移動指定的屬性，則根據新元素名稱，來自 DTD 的預設屬性會被更新。 此外，實作可能會更新其他結構的預設屬性。 應用程式應使用 Document.normalizeDocument() 以確保這些屬性 up-to-date。 <br>當被重新命名的節點是 Attr ，且 連接在 Element時，該節點首先會從屬性映射中移除 Element 。 然後，一旦重新命名，無論是修改現有節點還是如上所述建立新節點，就會重新命名。 <此外，ul>li 會觸發使用者資料事件<，>當實作支援「MutationNameEvents」功能時，觸發 /li<>liNODE_RENAMED，每個變異操作都會觸發相應事件，最終觸發事件 {<， >} 或 {<， >}。http://www.w3.org/2001/xml-eventsDOMElementNameChangedhttp://www.w3.org/2001/xml-eventsDOMAttributeNameChanged </li></ul>

新增於DOM第三級。

的 org.w3c.dom.Document.renameNode(org.w3c.dom.Node, java.lang.String, java.lang.String)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於