XmlAttribute.InsertBefore(XmlNode, XmlNode) Methode

Definition

Fügt den angegebenen Knoten unmittelbar 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 Text XmlNode .

refChild
XmlNode

Das XmlNode ist der Referenzknoten. Dies newChild wird vor diesem Knoten platziert.

Gibt zurück

Das XmlNode eingefügte.

Ausnahmen

Der aktuelle Knoten weist einen Typ auf, der untergeordnete Knoten des Knotentyps newChild nicht zulässt.

Dies newChild ist ein Vorgänger dieses Knotens.

Die newChild Datei wurde aus einem anderen Dokument als dem Dokument erstellt, das diesen Knoten erstellt hat.

Dies refChild ist kein untergeordnetes Element dieses Knotens.

Dieser Knoten ist schreibgeschützt.

Beispiele

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

Hinweise

Wenn refChild ja null, fügen Sie newChild am Ende der Liste der untergeordneten Knoten ein. Wenn newChild es sich um ein XmlDocumentFragment Objekt handelt, werden die 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: