XmlAttribute.PrependChild(XmlNode) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет указанный узел в начало списка дочерних узлов данного узла.
public:
override System::Xml::XmlNode ^ PrependChild(System::Xml::XmlNode ^ newChild);
public override System.Xml.XmlNode PrependChild (System.Xml.XmlNode newChild);
public override System.Xml.XmlNode? PrependChild (System.Xml.XmlNode newChild);
override this.PrependChild : System.Xml.XmlNode -> System.Xml.XmlNode
Public Overrides Function PrependChild (newChild As XmlNode) As XmlNode
Параметры
- newChild
- XmlNode
Добавляемый объект XmlNode. Для узлов XmlDocumentFragment все содержимое фрагмента документа перемещается в дочерний список данного узла.
Возвращаемое значение
Добавленный узел XmlNode.
Исключения
Данный узел относится к типу, который не допускает дочерних узлов типа newChild
.
Узел newChild
является предком данного узла.
Узел newChild
был создан из другого документа, отличного от документа, из которого был создан этот узел.
Этот узел доступен только для чтения.
Примеры
Пример PrependChild метода см. в описании PrependChild метода.
Комментарии
Если дерево newChild
уже находится, сначала удаляется.
Если вставленный узел был создан из другого документа, можно использовать для XmlDocument.ImportNode импорта узла в текущий документ. Затем импортированный узел можно вставить в текущий документ.
Этот метод является расширением Майкрософт для модели объектов документов (DOM).