XmlDocument.InsertBefore(IXmlNode, IXmlNode) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt einen untergeordneten Knoten links vom angegebenen Knoten oder am Ende der untergeordneten Knotenliste 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 IXmlNodeParameter
- 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
Bei Erfolg der untergeordnete Knoten, der eingefügt wurde. Bei NULL wird kein Objekt erstellt.