Ler em inglês

Compartilhar via


XmlEntityReference.InsertBefore(IXmlNode, IXmlNode) Método

Definição

Insere um nó filho à esquerda do nó especificado ou no final da lista.

public IXmlNode InsertBefore(IXmlNode newChild, IXmlNode referenceChild);

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

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

Implementações

Aplica-se a

Produto Versões
WinRT Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100