XmlComment.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 Liste ein. Diese Methode gilt nicht für diese Klasse und löst eine Ausnahme aus.
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 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.