cloneNode Method
9/8/2008
Clona um novo nó.
Sintaxe de script
var objXMLDOMNode = oXMLDOMNode.cloneNode(deep);
Comentários
Parâmetros de script
- profunda
Boolean. Sinalizador que indica se clone recursivamente todos os nós que são descendentes neste nó. Se for TRUE, criar um clone do completo árvore abaixo neste nó. Se FALSE, clone neste nó e seus atributos somente.
Valor Return script
Objeto. Retorna o nó clone recém-criado.
C/sintaxe C++
HRESULT cloneNode(
VARIANT_BOOL deep,
IXMLDOMNode** cloneRoot
);
Comentários
C/parâmetros C++
- profunda
[no] Sinalizador que indica se clone recursivamente todos os nós que são descendentes neste nó. Se for TRUE, criar um clone do completo árvore abaixo neste nó. Se FALSE, clone neste nó e seus atributos somente.
- cloneRoot
[out, retval] Recém-criadas nó clone.
C/valores Return C++
- S_OK
Valor retornado se bem-sucedido.
- E_INVALIDARG
Valor retornado se cloneRoot é nulo.
Requisitos
Header | msxml2.h, msxml2.idl |
Library | uuid.lib |
Windows Embedded CE | Windows CE .NET 4.0 and later |
Comentários Gerais
O nó clonado possui os mesmo valores propriedade como este nó para o seguinte propriedades: nodeName Property, nodeValue, NodeType, parentNode, ownerDocument, e, se ele for um elemento, Atributos. O valor do clone ChildNodes depende de como a configuração do profunda parâmetro sinalizador.
Observação
Se o nó é o DOMDocument nó, ele é mais seguro para clone o documento usando o salvar método, como segue.doc.Save(doc2);
Este método se aplica ao seguinte objetos e interfaces:
IXMLDOMAttribute, IXMLDOMCDATASection, IXMLDOMCharacterData, IXMLDOMComment, DOMDocument, IXMLDOMDocumentFragment, IXMLDOMDocumentType, IXMLDOMElement, IXMLDOMEntity, IXMLDOMEntityReference, IXMLDOMNode, IXMLDOMNotation, IXMLDOMProcessingInstruction, IXMLDOMText, e IXTLRuntime.
See Also
Concepts
nodeValue Property
nodeType Property
parentNode Property
ownerDocument Property
attributes Property
childNodes Property