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

Other Resources