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


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

Определение

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

public:
 IXmlNode ^ InsertBefore(IXmlNode ^ newChild, IXmlNode ^ referenceChild);
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, объект не создается.

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