XmlAttribute.InsertBefore(XmlNode, XmlNode) Metoda

Definicja

Wstawia określony węzeł bezpośrednio przed określonym węzłem odniesienia.

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

Parametry

newChild
XmlNode

Obiekt XmlNode do wstawienia.

refChild
XmlNode

Jest XmlNode to węzeł odniesienia. Element newChild jest umieszczany przed tym węzłem.

Zwraca

XmlNode

Wstawiono XmlNode .

Wyjątki

Bieżący węzeł jest typu, który nie zezwala na węzły podrzędne typu węzła newChild .

Element newChild jest elementem nadrzędnym tego węzła.

Obiekt newChild został utworzony na podstawie innego dokumentu niż ten, który utworzył ten węzeł.

Element refChild nie jest elementem podrzędnym tego węzła.

Ten węzeł jest tylko do odczytu.

Przykłady

Aby zapoznać się z przykładem InsertBefore metody, zobacz metodę InsertBefore .

Uwagi

Jeśli refChild parametr ma nullwartość , wstaw newChild na końcu listy węzłów podrzędnych. Jeśli newChild obiekt jest obiektem XmlDocumentFragment , jego węzły podrzędne są wstawiane w tej samej kolejności przed refChild. Jeśli element newChild znajduje się już w drzewie, jest najpierw usuwany.

Jeśli wstawiony węzeł został utworzony na podstawie innego dokumentu, możesz użyć XmlDocument.ImportNode polecenia , aby zaimportować węzeł do bieżącego dokumentu. Zaimportowany węzeł można następnie wstawić do bieżącego dokumentu.

Dotyczy