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

Метод XML_КУРСОР.СОХРАНИТЬ

Сохраняет связанный с курсором XML-документ в файл.

ФУНКЦИЯ ЛОГИКА: СОХРАНИТЬ(СТРОКА: путь = "";
                          СТРОКА: опции = "")

Параметры

путь
Путь для сохранения. Если путь не задан, то используется путь, переданный в метод ОТКРЫТЬ_ФАЙЛ или СОЗДАТЬ_ФАЙЛ (если эти методы ранее вызывались для этого курсора).
опции
Опции сохранения:
  • "" – никаких дополнительных действий (по умолчанию);
  • "F" – применить форматирование для нового документа (созданного ранее методом СОЗДАТЬ_ФАЙЛ);
  • "E" – применить форматирование принудительно для любого документа (может привести к нежелательным результатам, если файл уже содержал какое-либо форматирование).
  • "W" – удалить пробельные текстовые узлы, кроме одиночных. Может применяться для удаления ранее выполненного форматирования.

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

ДА – при успешном сохранении, НЕТ – в противном случае. Текстовое сообщение об ошибке можно получить с помощью функции ПОСЛ_НФ_ОШИБКА.

Замечание.

Форматирование XML при сохранении заключается в том, что для элементов добавляются переносы строк и отступы в два пробела на каждый уровень вложенности элементов. Для загруженных из файла или строки документов форматирование не применяется, т.к. такие документы уже могут содержать какой-либо вариант форматирования.

При открытии отформатированного документа режиме расширенной поддержки текстовых узлов фрагменты текста, добавленные при форматировании, будут видны как отдельные узлы PCDATA или войдут в состав других текстовых фрагментов.


См. также: