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

Definição

Namespace:: Org.W3c.Dom

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Renomear um nó existente do tipo 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

Parâmetros

n: INode

O nó a ser renomeado.

namespaceURI: String

O novo URI do namespace.

qualifiedName: String

O novo nome qualificado.

Retornos

INode

O nó renomeado. Esse é o nó especificado ou o novo nó que foi criado para substituir o nó especificado.

Atributos: RegisterAttribute

Exceções

DOMException

NOT_SUPPORTED_ERR: Gerado quando o tipo do nó especificado não é nem ELEMENT_NODE nem ATTRIBUTE_NODE, ou se a implementação não dá suporte à renomeação do elemento de documento.
INVALID_CHARACTER_ERR: gerado se o novo nome qualificado não for um nome XML de acordo com a versão XML em uso especificada no Document.xmlVersion atributo.
WRONG_DOCUMENT_ERR: gerado quando o nó especificado foi criado a partir de um documento diferente deste documento.
NAMESPACE_ERR: Gerado se for qualifiedName um nome qualificado malformado, se o qualifiedName tiver um prefixo e o namespaceURI for null, ou se o qualifiedName prefixo for "xml" e o namespaceURI for diferente de "" [] . Também gerado, quando o nó que está sendo renomeado é um atributo, se o qualifiedName, ou seu prefixo, é "xmlns" e o namespaceURI é diferente de "".

Comentários

Renomear um nó existente do tipo ELEMENT_NODE ou ATTRIBUTE_NODE. Quando possível, isso simplesmente altera o nome do nó fornecido, caso contrário, isso cria um novo nó com o nome especificado e substitui o nó existente pelo novo nó, conforme descrito abaixo. Se simplesmente não for possível alterar o nome do nó fornecido, as seguintes operações serão executadas: um novo nó é criado, qualquer ouvinte de evento registrado é registrado no novo nó, todos os dados de usuário anexados ao nó antigo são removidos desse nó, o nó antigo é removido de seu pai se ele tiver um, os filhos serão movidos para o novo nó, se o nó renomeado for um Element dos atributos movidos para o novo nó, o novo nó será inserido na posição que o nó antigo costumava ter na lista de nós filho do pai se tiver um, os dados do usuário anexados ao nó antigo serão anexados ao novo nó. Quando o nó que está sendo renomeado é apenas um Element dos atributos especificados são movidos, os atributos padrão originados do DTD são atualizados de acordo com o novo nome do elemento. Além disso, a implementação pode atualizar atributos padrão de outros esquemas. Os aplicativos devem ser usados Document.normalizeDocument() para garantir que esses atributos sejam up-to-date. Quando o nó que está sendo renomeado é um Attr anexado a um Element, o nó é removido pela primeira vez do Element mapa de atributos. Em seguida, uma vez renomeado, modificando o nó existente ou criando um novo, conforme descrito acima, ele é colocado novamente. Além disso, <ul><li> um evento NODE_RENAMED de dados do usuário é acionado, </li><li> quando a implementação dá suporte ao recurso "MutaçãoNameEvents", cada operação de mutação envolvida nesse método dispara o evento apropriado e, no final, o evento {http://www.w3.org/2001/xml-events, DOMElementNameChanged} ou {http://www.w3.org/2001/xml-events, DOMAttributeNameChanged} é acionado. </li></ul>

Adicionado no Nível 3 do DOM.

Java documentação para org.w3c.dom.Document.renameNode(org.w3c.dom.Node, java.lang.String, java.lang.String).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a