XmlText.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, объект не создается.