Руководство разработчика

Метод XML_КУРСОР.ДОБАВИТЬ_УЗЕЛ

Создает новый узел XML-документа. Узел добавляется в качестве дочернего для узла, связанного с курсором. В результате добавления курсор связывается с новым узлом. Это позволяет тут же установить его текст (ЗАП_ТЕКСТ) и атрибуты (ЗАП_АТРИБУТ). При добавлении узлов в цикле, перед добавлением очередного узла необходимо вернуть курсор обратно к родительскому узлу при помощи метода ВВЕРХ.

ФУНКЦИЯ ДОБАВИТЬ_УЗЕЛ(СТРОКА: имя; 
                      ЦЕЛОЕ: позиция = 0)

Параметры

имя
Имя добавляемого узла.

Имя узла может содержать префикс пространства имен (namespace). Например, "myns:Node", где myns – имя пространства имен. Определение пространства имен должно содержаться с этом же или в одном из вышестоящих узлов.

Если объявление пространства имен должно быть указано как атрибут этого же узла, то URI пространства имен необходимо указать в имени узла через пробел.
Например, "myns:Node http://schemas.mysample.com/123".
В результате будет создан узел следующего вида:
<myns:Node xmlns:myns="http://schemas.mysample.com/123" />
позиция
Позиция вставки нового узла. Новый узел размещается перед узлом с заданной позицией. Если позиция не задана или находится вне пределов допустимого диапазона, то новый узел добавляется в конец. Нумерация узлов начинается с 1.

В режиме расширенной поддержки текстовых узлов возможно добавление узлов типа PCDATA или CDATA. У текстовых узлов нет имени. Для добавления текстового узла в параметре имя надо указать "#PCDATA" или "#CDATA". Новый текстовый узел не содержит текста. Для установки текста надо воспользоваться методом ЗАП_ТЕКСТ.


См. также: