Прочитать на английском

Поделиться через


XmlNode.PrependChild(XmlNode) Метод

Определение

Добавляет указанный узел в начало списка дочерних узлов данного узла.

public virtual System.Xml.XmlNode PrependChild (System.Xml.XmlNode newChild);
public virtual System.Xml.XmlNode? PrependChild (System.Xml.XmlNode newChild);

Параметры

newChild
XmlNode

Добавляемый узел. Все содержимое узла, которое должно быть добавлено, перемещается в указанное расположение.

Возвращаемое значение

XmlNode

Добавленный узел.

Исключения

Данный узел относится к типу, который не допускает дочерних узлов типа newChild.

Узел newChild является предком данного узла.

Узел newChild был создан из другого документа, отличного от документа, из которого был создан этот узел.

Этот узел доступен только для чтения.

Примеры

В следующем примере в XML-документ добавляется новый узел.

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.DocumentElement;

    //Create a new node.
    XmlElement elem = doc.CreateElement("price");
    elem.InnerText="19.95";

    //Add the node to the document.
    root.PrependChild(elem);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);
  }
}

Комментарии

Если дерево newChild уже находится в дереве, оно удаляется из исходного положения и добавляется в целевое положение. Дополнительные сведения о вставке узлов см. в разделе "Вставка узлов" в XML-документ.

Если вставляемый узел был создан из другого документа, можно импортировать XmlDocument.ImportNode узел в текущий документ. Затем импортированный узел можно вставить в текущий документ.

Этот метод является расширением Майкрософт для модели DOM.

Примечания для тех, кто наследует этот метод

При переопределении PrependChild в производном классе для правильного создания событий необходимо вызвать PrependChild метод базового класса.

Применяется к

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 2.0, 2.1
UWP 10.0

См. также раздел