IXmlNode.InsertBefore(IXmlNode, IXmlNode) Método
Definição
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.
Insere um nó filho à esquerda do nó especificado ou no final da lista.
public:
IXmlNode ^ InsertBefore(IXmlNode ^ newChild, IXmlNode ^ referenceChild);IXmlNode InsertBefore(IXmlNode const& newChild, IXmlNode const& referenceChild);public IXmlNode InsertBefore(IXmlNode newChild, IXmlNode referenceChild);function insertBefore(newChild, referenceChild)Public Function InsertBefore (newChild As IXmlNode, referenceChild As IXmlNode) As IXmlNodeParâmetros
- newChild
- IXmlNode
O endereço do novo nó a ser inserido. O nó passado aqui deve ser um filho válido do nó de documento XML DOM atual. Por exemplo, se o nó atual for um atributo, você não poderá passar outro atributo no parâmetro newChild , pois um atributo não pode ter um atributo como filho. Se newChild for um tipo de nó DOCUMENT_FRAGMENT, todos os seus filhos serão inseridos em ordem antes de referenceChild.
Se newChild já estiver na árvore, ela será removida primeiro antes de ser reinserida antes do nó referenceChild . Nós somente leitura, como nós NODE_DOCUMENT_TYPE e NODE_ENTITY, não podem ser passados no parâmetro newChild .
- referenceChild
- IXmlNode
O nó de referência. O nó especificado é onde o nó newChild deve ser inserido à esquerda como o irmão anterior na lista filho. O nó passado aqui deve ser um nó filho do nó atual ou nulo. Se o valor for nulo, o nó newChild será inserido no final da lista filho. Se o nó referenceChild não for um filho do nó atual, um erro será retornado.
Retornos
Em caso de êxito, o nó filho que foi inserido. Se for nulo, nenhum objeto será criado.