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

Element XmlNode do wstawienia.

refChild
XmlNode

Jest XmlNode to węzeł odniesienia. Element newChild zostanie umieszczony przed tym węzłem.

Zwraca

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 ma wartość null, 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, zostanie on najpierw usunięty.

Jeśli wstawiony węzeł został utworzony z 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