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

Метод XML_КУРСОР.СОЗДАТЬ_ФАЙЛ

Создает новый XML-документ и добавляет туда заданную инструкцию и корневой узел. Объект связывается с корневым узлом документа.

ФУНКЦИЯ СОЗДАТЬ_ФАЙЛ(СТРОКА: путь; 
                     СТРОКА: инструкция; 
                     СТРОКА: корневой_элемент;
                     СТРОКА: опции = "")

Параметры

путь
Путь к XML-файлу.
инструкция
Атрибуты инструкции xml, добавляемой в новый документ, а также дополнительные инструкции обработки (processing instructions). Например:
"version=""1.0"" encoding=""windows-1251"""
Инструкция xml определяет кодировку XML-файла. Если указана пустая строка, то добавляется стандартная инструкция xml: <?xml version="1.0"?>, подразумевающая кодировку utf-8.
корневой_элемент
Имя корневого узла документа.

Имя корневого узла может содержать префикс пространства имен (namespace). Например, "myns:Root", где myns – имя пространства имен. Для корневого узла определение пространства имен должно быть указано как атрибут этого же узла. URI пространства имен необходимо указать в имени узла через пробел.
Например, "myns:Root http://schemas.mysample.com/123".
В результате будет создан узел следующего вида:
<myns:Root xmlns:myns="http://schemas.mysample.com/123" />
опции
Опции создания курсора:

Для добавления дополнительных инструкций используется разделитель "?". Указывается имя инструкции и, если необходимо, список атрибутов.
Например:

"version=""1.0"" encoding=""utf-8""?MyInstruction?AnotherInstruction someattr=""someval"""

В файле будут добавлены следующие инструкции:

<?xml version="1.0" encoding="utf-8"?>
<?MyInstruction ?>
<?AnotherInstruction someattr="someval"?>

Замечание

Для существующего файла атрибуты инструкции xml и набор дополнительных инструкций может быть изменен вызовом метода ИЗМЕНИТЬ_ИНСТРУКЦИЮ.


См. также: