1С: как записать строку в файл

Запись строки в файл — одна из базовых операций при разработке на встроенном языке 1С. Она нужна при выгрузке данных в обменные форматы, формировании логов, создании CSV-файлов, выгрузке отчётов во внешние системы и отладке алгоритмов. Платформа предоставляет для этого несколько объектов, и выбор зависит от задачи: объём данных, кодировка, необходимость дописывать в существующий файл.

Основные инструменты — объекты ЗаписьТекста и ТекстовыйДокумент, а также потоковые средства ЗаписьДанных для бинарных сценариев. Ниже разобраны рабочие примеры кода, различия между объектами, работа с кодировками, добавление строк в конец файла и типичные ошибки, из-за которых файл оказывается пустым или повреждённым.

Запись строки через объект ЗаписьТекста

Объект ЗаписьТекста — основной способ последовательной записи текста в файл. Он подходит для больших файлов, так как пишет данные порциями, не загружая весь текст в память. Минимальный пример выглядит так:

Запись = Новый ЗаписьТекста("C:\Temp\output.txt", КодировкаТекста.UTF8);
Запись.ЗаписатьСтроку("Первая строка файла");
Запись.ЗаписатьСтроку("Вторая строка файла");
Запись.Закрыть();

Метод ЗаписатьСтроку() добавляет после текста символ перевода строки. Если перевод не нужен, используйте метод Записать(), который пишет текст как есть. Это важно при формировании файлов со строгой структурой, где лишний перевод строки нарушит формат.

Вызов Закрыть() обязателен: без него данные могут остаться в буфере и не попасть на диск, а сам файл будет заблокирован для других процессов. В надёжном коде запись оборачивают в попытку с гарантированным закрытием в блоке исключения.

Запись = Новый ЗаписьТекста(ИмяФайла, КодировкаТекста.UTF8);
Запись.ЗаписатьСтроку(ТекстДляЗаписи);
Запись.Закрыть();

Запись через ТекстовыйДокумент

Объект ТекстовыйДокумент удобен, когда текст сначала формируется в памяти: строки можно добавлять, заменять, вставлять в произвольную позицию, а затем одной командой сохранить в файл. Это хороший вариант для небольших файлов и шаблонов.

Документ = Новый ТекстовыйДокумент;
Документ.ДобавитьСтроку("Шапка файла");
Документ.ДобавитьСтроку("Строка данных");
Документ.Записать("C:\Temp\output.txt", КодировкаТекста.UTF8);

Дополнительные методы УстановитьТекст() и ПолучитьТекст() позволяют работать с содержимым целиком. Помните об ограничении: весь документ хранится в оперативной памяти, поэтому для выгрузок в десятки и сотни мегабайт лучше использовать ЗаписьТекста.

Кодировка файла: как не получить нечитаемый текст

Кодировка указывается вторым параметром конструктора ЗаписьТекста или метода Записать(). Чаще всего используют КодировкаТекста.UTF8 — современный стандарт для обмена. Если файл должен открываться в старых программах Windows, может потребоваться КодировкаТекста.ANSI, а для некоторых внешних систем — UTF16 или OEM.

Если кодировку не указать, применяется значение по умолчанию, которое зависит от настроек системы. Это частая причина «кракозябр» при открытии файла на другом компьютере. Явное указание кодировки делает поведение кода предсказуемым.

Для CSV-файлов, которые будут открываться в Excel, учтите: Excel корректно распознаёт UTF-8 при наличии BOM (метки порядка байтов). В ЗаписьТекста запись BOM можно включить третьим параметром конструктора, передав Истина.

Добавление строк в существующий файл

По умолчанию ЗаписьТекста перезаписывает файл. Чтобы дописать строки в конец, передайте в конструктор параметр Дописывать со значением Истина:

Запись = Новый ЗаписьТекста("C:\Temp\log.txt", КодировкаТекста.UTF8, , Истина);
Запись.ЗаписатьСтроку("Новая запись в журнале");
Запись.Закрыть();

Такой режим полезен для журналирования: каждый запуск обработки добавляет записи, не затирая предыдущие. Перед записью стоит проверить существование файла через ФайлСуществует() или объект Файл, если логика обработки различается для нового и существующего файла.

Запись на сервере и на клиенте: в чём разница

Путь к файлу интерпретируется относительно того узла, где выполняется код. В серверной процедуре путь C:\Temp\... указывает на диск сервера 1С, а не компьютера пользователя. Это типичная ошибка: разработчик ищет файл у себя, а он создан на сервере.

В клиент-серверном режиме сначала сформируйте файл на сервере, затем передайте его клиенту через временное хранилище (ПоместитьВоВременноеХранилище) и сохраните методом ПолучитьФайл() или через диалог сохранения. В файловом режиме тонкого клиента запись возможна напрямую, если у пользователя есть права на каталог.

Обработка ошибок и проверка результата

Запись в файл может завершиться ошибкой: нет прав на каталог, диск переполнен, путь не существует, файл занят другим процессом. Оборачивайте операции в Попытка ... Исключение ... КонецПопытки и фиксируйте текст ошибки через ОписаниеОшибки() или ИнформацияОбОшибке().

Попытка
Запись = Новый ЗаписьТекста(ИмяФайла, КодировкаТекста.UTF8);
Запись.ЗаписатьСтроку(Текст);
Запись.Закрыть();
Исключение
Сообщить("Ошибка записи файла: " + ОписаниеОшибки());
КонецПопытки;

После записи полезно проверить результат: существует ли файл и ненулевой ли он размер. Для этого используйте объект Файл и его свойства Существует() и Размер(). В каталоге записи у учётной записи, под которой работает сервер 1С, должны быть права на создание и изменение файлов.

Частые вопросы