IXmlNode.InsertBefore(IXmlNode, IXmlNode) Método

Definição

Namespace:

Windows.Data.Xml.Dom

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 IXmlNode

Parâ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

IXmlNode

Em caso de êxito, o nó filho que foi inserido. Se for nulo, nenhum objeto será criado.