XmlAttribute.InsertBefore(XmlNode, XmlNode) Methode

Definition

Fügt den angegebenen Knoten direkt vor dem angegebenen Verweisknoten ein.

public:
 override System::Xml::XmlNode ^ InsertBefore(System::Xml::XmlNode ^ newChild, System::Xml::XmlNode ^ refChild);
public override System.Xml.XmlNode InsertBefore (System.Xml.XmlNode newChild, System.Xml.XmlNode refChild);
public override System.Xml.XmlNode? InsertBefore (System.Xml.XmlNode newChild, System.Xml.XmlNode? refChild);
override this.InsertBefore : System.Xml.XmlNode * System.Xml.XmlNode -> System.Xml.XmlNode
Public Overrides Function InsertBefore (newChild As XmlNode, refChild As XmlNode) As XmlNode

Parameter

newChild
XmlNode

Der einzufügende XmlNode.

refChild
XmlNode

Der XmlNode, der der Verweisknoten ist. Das newChild wird vor diesem Knoten platziert.

Gibt zurück

XmlNode

Der eingefügte XmlNode.

Ausnahmen

Der Typ des aktuellen Knotens lässt keine untergeordneten Knoten vom Typ des newChild-Knotens zu.

newChild ist eine frühere Version dieses Knotens.

newChild wurde nicht aus dem Dokument erstellt, aus dem dieser Knoten erstellt wurde.

refChild ist kein untergeordnetes Element dieses Knotens.

Dieser Knoten ist schreibgeschützt.

Beispiele

Ein Beispiel für die Methode finden Sie in der InsertBefore InsertBefore Methode.

Hinweise

nullWenn refChild es sich handelt, fügen Sie newChild am Ende der Liste untergeordneter Knoten ein. Wenn newChild es sich um ein XmlDocumentFragment Objekt handelt, werden seine untergeordneten Knoten in derselben Reihenfolge eingefügt, bevor refChild. Wenn sich die newChild Struktur bereits befindet, wird sie zuerst entfernt.

Wenn der eingefügte Knoten aus einem anderen Dokument erstellt wurde, können XmlDocument.ImportNode Sie den Knoten in das aktuelle Dokument importieren. Der importierte Knoten kann dann in das aktuelle Dokument eingefügt werden.

Gilt für