XmlDocument.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 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.