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

Метод ЯРД_ДОКУМЕНТ.СОХРАНИТЬ

Метод СОХРАНИТЬ позволяет сохранить в файл логическое представление документа.

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

Параметры

путь
Путь к файлу, в который необходимо сохранить документ. Если файл с указанным именем уже существует, он будет перезаписан. Если путь не указан, документ сохраняется в файл, который был ассоциирован с ним при вызове метода ОТКРЫТЬ.

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

ДА – при успешном сохранении, НЕТ – в случае ошибки. В частности, ошибка может возникнуть, если представление документа не связано ни с каким файлом (метод ОТКРЫТЬ вызывался без параметра путь) и метод СОХРАНИТЬ также вызывается без параметра.

При сохранении документа учитывается кодировка текста, заданная в исходном документе. При создании нового документа по умолчанию используется кодировка UTF-8. Для задания другой кодировки необходимо добавить соответствующую инструкцию xml. Например, так может выглядеть инструкция для сохранения в кодировке Windows cp1251:

ПЕРЕМ ЯРД_ДОКУМЕНТ: док
док.ОТКРЫТЬ( ДА )    // создали новый

// добавляем инструкцию xml
ПЕРЕМ ЯРД_Т_УЗЕЛ: инстр
док.СОЗДАТЬ_Т_УЗЕЛ(
    ЯРД_СОБРАТЬ_ИНСТРУКЦИЮ("xml", "version='1.0' encoding='windows-1251'"),
    ЯРД_ТУЗИНСТРУКЦИЯ,
    инстр)
док.ДОБАВИТЬ_УЗЕЛ(инстр)

// … формируем документ

док.СОХРАНИТЬ( "c:\my_file.xml" )

Замечание: после сохранения документ не становится ассоциированным с файлом, в который его сохранили.


См. также: