IXmlNode.InsertBefore(IXmlNode, IXmlNode) Método

Definición

Espacio de nombres:

Windows.Data.Xml.Dom

Inserta un nodo secundario a la izquierda del nodo especificado o al final de la 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

Dirección del nuevo nodo que se va a insertar. El nodo pasado aquí debe ser un elemento secundario válido del nodo de documento XML DOM actual. Por ejemplo, si el nodo actual es un atributo, no puede pasar otro atributo en el parámetro newChild , ya que un atributo no puede tener un atributo como secundario. Si newChild es un tipo de nodo DOCUMENT_FRAGMENT, todos sus elementos secundarios se insertan en orden antes de referenceChild.

Si newChild ya está en el árbol, primero se quita antes de que se vuelva a insertar antes del nodo referenceChild . Los nodos de solo lectura, como NODE_DOCUMENT_TYPE y NODE_ENTITY nodos, no se pueden pasar en el parámetro newChild .

referenceChild

IXmlNode

Nodo de referencia. El nodo especificado es donde se va a insertar el nodo newChild a la izquierda como el elemento relacionado anterior en la lista secundaria. El nodo pasado aquí debe ser un nodo secundario del nodo actual o null. Si el valor es null, el nodo newChild se inserta al final de la lista secundaria. Si el nodo referenceChild no es un elemento secundario del nodo actual, se devuelve un error.

Devoluciones

IXmlNode

Si se ejecuta correctamente, el nodo secundario que se insertó. Si es null, no se crea ningún objeto.