Condividi tramite


XmlDocument.InsertBefore(IXmlNode, IXmlNode) Metodo

Definizione

Inserisce un nodo figlio a sinistra del nodo specificato o alla fine dell'elenco di nodi figlio.

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

Parametri

newChild
IXmlNode

Indirizzo del nuovo nodo da inserire. Il nodo passato qui deve essere un figlio valido del nodo documento DOM XML corrente. Ad esempio, se il nodo corrente è un attributo, non è possibile passare un altro attributo nel parametro newChild , perché un attributo non può avere un attributo come figlio. Se newChild è un tipo di nodo DOCUMENT_FRAGMENT, tutti i relativi elementi figlio vengono inseriti in ordine prima di referenceChild.

Se newChild si trova già nell'albero, viene prima rimosso prima di essere reinsertato prima del nodo referenceChild . I nodi di sola lettura, ad esempio NODE_DOCUMENT_TYPE e NODE_ENTITY nodi, non possono essere passati nel parametro newChild .

referenceChild
IXmlNode

Nodo di riferimento. Il nodo specificato è dove deve essere inserito il nodo newChild a sinistra come elemento di pari livello precedente nell'elenco figlio. Il nodo passato qui deve essere un nodo figlio del nodo corrente o Null. Se il valore è Null, il nodo newChild viene inserito alla fine dell'elenco figlio. Se il nodo referenceChild non è un elemento figlio del nodo corrente, viene restituito un errore.

Restituisce

In caso di esito positivo, il nodo figlio inserito. Se null, non viene creato alcun oggetto.

Implementazioni

Si applica a