DtdEntity.InsertBefore(IXmlNode, IXmlNode) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inserta un nodo secundario a la izquierda del nodo especificado o al final de la lista de nodos secundarios.
public:
virtual IXmlNode ^ InsertBefore(IXmlNode ^ newChild, IXmlNode ^ referenceChild) = InsertBefore;
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
Si se ejecuta correctamente, el nodo secundario que se insertó. Si es null, no se crea ningún objeto.