replaceChild Method
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
O nó filho antigo especificado substitui o nó filho novo fornecido.
Sintaxe de script
var objXMLDOMNode = oXMLDOMNode.replaceChild(newChild, oldChild);
Comentários
.gif)
Parâmetros de script
- newChild
Objeto. Endereço do novo filho que deve substituir o antigo filho. Se nulo, oldChild é removido sem um substituto.
- oldChild
Objeto. Endereço do filho antigo a ser substituído pelo novo filho.
Valor Return script
Objeto. Retorna o filho antigo que é substituído.
C/sintaxe C++
HRESULT replaceChild(
IXMLDOMNode* newChild,
IXMLDOMNode* oldChild,
IXMLDOMNode** outOldChild
);
Comentários
C/parâmetros C++
- newChild
[no] Endereço do novo filho que deve substituir o antigo filho. Se nulo, oldChild é removido sem um substituto.
- oldChild
[no] Endereço do filho antigo a ser substituído pelo novo filho.
- outOldChild
[out, retval] Antigo filho que é substituído. Se NULL, nenhum objeto é criado.
C/valores Return C++
- S_OK
Valor retornado se bem-sucedido.
- E_INVALIDARG
Valor retornado se a newChild nó não pode ser inserido como um filho neste nó, quando especificada oldChild não é um filho neste nó, ou se oldChild é 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
Esta operação depende de como o valor da NodeType propriedade.
NODE_ATTRIBUTE
Esta operação depende de como o valor da newChild parâmetro:
| Valor | Descrição |
|---|---|
NODE_ATTRIBUTE, NODE_CDATA_SECTION, NODE_COMMENT, NODE_DOCUMENT, NODE_DOCUMENT_TYPE, NODE_ELEMENT, NODE_ENTITY, NODE_NOTATION, NODE_PROCESSING_INSTRUCTION |
Retorna um erro. Esses tipos nó não podem ser filhos de um atributo. |
NODE_DOCUMENT_FRAGMENT |
Substitui oldChild Com os filhos do fragmento de documento no newChild e retorna oldChild. |
NODE_ENTITY_REFERENCE, NODE_TEXT |
Substitui o especificado oldChild Com o fornecido newChild e retorna oldChild. |
NODE_CDATA_SECTION, NODE_COMMENT, NODE_ENTITY, NODE_NOTATION, NODE_PROCESSING_INSTRUCTION, NODE_TEXT |
Retorna um erro. Esses tipos nó ou não podem ter filhos ou seus filhos são somente leitura. |
NODE_DOCUMENT
Esta operação depende de como o valor da newChild parâmetro.
| Valor | Descrição |
|---|---|
NODE_ATTRIBUTE, NODE_CDATA_SECTION, NODE_DOCUMENT, NODE_ENTITY, NODE_ENTITY_REFERENCE, NODE_NOTATION, NODE_TEXT |
Retorna um erro. Esses nós não são válido como filhos do nó documento. |
NODE_COMMENT, NODE_PROCESSING_INSTRUCTION |
Substitui o especificado oldChild Com o fornecido newChild e retorna oldChild. |
NODE_DOCUMENT_TYPE, NODE_ELEMENT |
Substitui oldChild Com newChild e retorna oldChild. Por definição, um documento XML (o nó documento) pode ter apenas um único filho. Portanto, um erro será retornado se o nó documento já tem um filho. |
NODE_DOCUMENT_FRAGMENT |
Substitui o especificado oldChild Com os filhos do documento fragmento (newChild) e retorna oldChild. As operações de inserção são assunto as regras para nós filho e pode falhar se o filhos de fragmento documento representam tipos nó que não podem ser inseridos. |
NODE_DOCUMENT_TYPE |
Retorna um erro. Tipo de documento é somente leitura. |
NODE_DOCUMENT_FRAGMENT
Esta operação depende de como o valor da newChild parâmetro.
| Valor | Descrição |
|---|---|
NODE_ATTRIBUTE, NODE_DOCUMENT, NODE_DOCUMENT_TYPE |
Retorna um erro. Esses tipos nós não são válido como filhos do fragmento de documento. |
NODE_CDATA_SECTION, NODE_COMMENT, NODE_ELEMENT, NODE_ENTITY_REFERENCE, NODE_PROCESSING_INSTRUCTION, NODE_TEXT |
Substitui o especificado oldChild Com o fornecido newChild e retorna oldChild. |
NODE_DOCUMENT_FRAGMENT |
Substitui o especificado oldChild Com os filhos do documento fragmento (newChild) e retorna oldChild. As operações de inserção são assunto as regras para nós filho e pode falhar se o filhos de fragmento documento representam tipos nó que não podem ser inseridos. |
NODE_ENTITY, NODE_NOTATION |
Retorna um erro. Entidades e notações são somente leitura e não podem ser inseridas em um documento. |
NODE_ELEMENT
Esta operação depende de como o valor da newChild parâmetro.
| Valor | Descrição |
|---|---|
NODE_CDATA_SECTION, NODE_COMMENT, NODE_ELEMENT, NODE_ENTITY_REFERENCE, NODE_TEXT, NODE_PROCESSING_INSTRUCTION |
Substitui o especificado oldChild Com newChild e retorna oldChild. |
NODE_ATTRIBUTE, NODE_DOCUMENT, NODE_DOCUMENT_TYPE, NODE_ENTITY, NODE_NOTATION |
Retorna um erro. Esses tipos nó não podem ser filhos de um nó elemento. |
NODE_DOCUMENT_FRAGMENT |
Substitui o especificado oldChild Com os filhos do documento fragmento (newChild) e retorna oldChild. As operações de inserção são assunto as regras para nós filho e pode falhar se o filhos de fragmento documento representam tipos nó que não podem ser inseridos. |
NODE_ENTITY_REFERENCE |
Retorna um erro. Embora os nós filho de uma referência de entidade sejam a entidade expandida, os filhos não podem ser modificados. |
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.