IXmlNode.InsertBefore(IXmlNode, IXmlNode) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inserisce un nodo figlio a sinistra del nodo specificato o alla fine dell'elenco.
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 IXmlNodeParametri
- newChild
- IXmlNode
Indirizzo del nuovo nodo da inserire. Il nodo passato qui deve essere un figlio valido del nodo del 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 elemento figlio. Se newChild è un tipo di nodo DOCUMENT_FRAGMENT, tutti i relativi elementi figlio vengono inseriti in ordine prima di fare riferimentoChild.
Se newChild è già presente nell'albero, viene prima rimosso prima che venga 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 è il percorso in cui il nodo newChild deve essere inserito a sinistra come fratello 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 è 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.