XmlDocumentFragment.InsertBefore(IXmlNode, IXmlNode) Metodo

Definizione

Spazio dei nomi:

Windows.Data.Xml.Dom

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

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

IXmlNode

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

Implementazioni

InsertBefore(IXmlNode, IXmlNode)