XmlElement.InsertBefore(IXmlNode, IXmlNode) Methode

Definition

Namespace:

Windows.Data.Xml.Dom

Fügt einen untergeordneten Knoten links vom angegebenen Knoten oder am Ende der Liste ein.

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

Parameter

newChild

IXmlNode

Die Adresse des neuen Knotens, der eingefügt werden soll. Der hier übergebene Knoten muss ein gültiges untergeordnetes Element des aktuellen XML DOM-Dokumentknotens sein. Wenn der aktuelle Knoten z. B. ein Attribut ist, können Sie kein anderes Attribut im newChild-Parameter übergeben, da ein Attribut kein untergeordnetes Attribut haben kann. Wenn newChild ein DOCUMENT_FRAGMENT Knotentyp ist, werden alle untergeordneten Elemente in der Reihenfolge vor referenceChild eingefügt.

Wenn sich newChild bereits in der Struktur befindet, wird es zuerst entfernt, bevor es vor dem Knoten referenceChild erneut eingefügt wird. Schreibgeschützte Knoten, z. B. NODE_DOCUMENT_TYPE- und NODE_ENTITY-Knoten, können nicht im newChild-Parameter übergeben werden.

referenceChild

IXmlNode

Der Verweisknoten. Der angegebene Knoten ist der Knoten newChild , der links als vorheriger gleichgeordneter Knoten in der untergeordneten Liste eingefügt werden soll. Der hier übergebene Knoten muss entweder ein untergeordneter Knoten des aktuellen Knotens oder NULL sein. Wenn der Wert NULL ist, wird der newChild-Knoten am Ende der untergeordneten Liste eingefügt. Wenn der Knoten referenceChild kein untergeordnetes Element des aktuellen Knotens ist, wird ein Fehler zurückgegeben.

Gibt zurück

IXmlNode

Bei Erfolg der untergeordnete Knoten, der eingefügt wurde. Bei NULL wird kein Objekt erstellt.

Implementiert

InsertBefore(IXmlNode, IXmlNode)