appendChild Method

9/8/2008

Acrescenta newChild como o último filho do nó.

Sintaxe de script

var objXMLDOMNode = oXMLDOMNode.appendChild(newChild);

Comentários

Parâmetros de script

• newChild
  Objeto. Endereço da nova nó filho a ser acrescentado ao final de lista de filhos que pertencem a esse nó.

Valor Return script

Objeto. Retorna o novo nó filho anexado com êxito à lista.

Comentários de script

Observe que isso é equivalente ao chamado insertBefore(newChild, NULL). Para obter mais informações, consulte Método insertBefore.

C/sintaxe C++

HRESULT appendChild(
  IXMLDOMNode* newChild,
  IXMLDOMNode** outNewChild
);

Comentários

C/parâmetros C++

• newChild
  [no] Endereço da nova nó filho a serem acrescentadas ao final da lista de filhos neste nó.

• outNewChild
  [out, retval] Novo nó filho anexado com êxito à lista. Se NULL, nenhum objeto é criado.

C/valores Return C++

• S_OK
  Valor retornado se bem-sucedido.

• E_INVALIDARG
  Valor retornado se newChild é nulo.

• E_FAIL
  Valor retornado se ocorrerá um erro.

Requisitos

Header	msxml2.h, msxml2.idl
Library	uuid.lib
Windows Embedded CE	Windows CE .NET 4.0 and later

Comentários Gerais

Se newChild tem um pai existente, o nó é automaticamente removido esse pai antes que está sendo inserido em sua nova localidade.

Um nó mantém suas informações de espaço para nome mesmo quando movido. Mover um nó não cria uma declaração de espaço para nome; declarações são adicionadas ao recuperar a código-fonte XML (através de salvar Ou XML) para garantir que todos os espaços para nome sejam corretamente declarado.

Ao inserir um árvore de nós em outro nó que possui um documento proprietário diferente, o ownerDocument propriedade para cada nó inserido é alterada para coincidir com o documento proprietário de seu novo pai.

Quando mover um árvore de nós para outro documento, o de conteúdo de todos os nós referência de entidade contidos contidos é atualizado de acordo com o novo documento. Se o novo documento não declara uma entidade que foi movida para ele, o referência de entidade não terão nenhuma filhos, e o de conteúdo antigo é removido. Referências existentes para nós sob a referência de entidade ainda estão válido, mas o nó cujo pai anteriormente foi o referência de entidade agora tem uma NULL pai.

Observe que isso é equivalente ao chamado insertBefore(newChild, NULL). Para obter mais informações, consulte o Método insertBefore.

Este método se aplica ao seguinte objetos e interfaces:

IXMLDOMAttribute, IXMLDOMCDATASection, IXMLDOMCharacterData, IXMLDOMComment, DOMDocument, IXMLDOMDocumentFragment, IXMLDOMDocumentType, IXMLDOMElement, IXMLDOMEntity, IXMLDOMEntityReference, IXMLDOMNode, IXMLDOMNotation, IXMLDOMProcessingInstruction, IXMLDOMText, IXTLRuntime

See Also

Concepts

insertBefore Method
save Method
ownerDocument Property

Other Resources

XML