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


XmlDocument.InsertBefore(IXmlNode, IXmlNode) Метод

Определение

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

public:
 virtual IXmlNode ^ InsertBefore(IXmlNode ^ newChild, IXmlNode ^ referenceChild) = InsertBefore;
IXmlNode InsertBefore(IXmlNode const& newChild, IXmlNode const& referenceChild);
public IXmlNode InsertBefore(IXmlNode newChild, IXmlNode referenceChild);
function insertBefore(newChild, referenceChild)
Public Function InsertBefore (newChild As IXmlNode, referenceChild As IXmlNode) As IXmlNode

Параметры

newChild
IXmlNode

Адрес нового узла, который необходимо вставить. Переданный здесь узел должен быть действительным дочерним элементом текущего узла XML-документа DOM. Например, если текущий узел является атрибутом, нельзя передать другой атрибут в параметре newChild , так как атрибут не может иметь атрибут в качестве дочернего элемента. Если newChild является типом узла DOCUMENT_FRAGMENT, все его дочерние элементы вставляются по порядку перед referenceChild.

Если newChild уже находится в дереве, он сначала удаляется перед повторной вставкой перед узлом referenceChild . Узлы только для чтения, такие как узлы NODE_DOCUMENT_TYPE и NODE_ENTITY, нельзя передать в параметре newChild .

referenceChild
IXmlNode

Узел ссылки. Указанный узел — это место, где узел newChild должен быть вставлен слева как предыдущий одноуровневый узел в дочернем списке. Переданный здесь узел должен быть дочерним узлом текущего узла или иметь значение NULL. Если значение равно NULL, узел newChild вставляется в конец дочернего списка. Если узел referenceChild не является дочерним по отношению к текущему узлу, возвращается ошибка.

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

В случае успешного выполнения это дочерний узел, который был вставлен. Если значение равно null, объект не создается.

Реализации

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