Freigeben über


XmlEntityReference.InsertBefore(IXmlNode, IXmlNode) Methode

Definition

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 einzufügenden neuen Knotens. Der hier übergebene Knoten muss ein gültiges untergeordnetes Element des aktuellen XML-DOM-Dokumentknotens sein. Wenn der aktuelle Knoten beispielsweise 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 newChild bereits in der Struktur vorhanden ist, 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 Ort, an dem der Knoten newChild links als vorheriges gleichgeordnetes Element 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

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

Implementiert

Gilt für: