ТекстовыйДокумент.УстановитьТипФайла

Методы · SetFileType

Устанавливает кодировку файла, в которой будет сохранен текстовый документ при интерактивной записи (например, при выборе пункта "Файл - Печать").

Синтаксис

УстановитьТипФайла(<Тип>)
Полное описание, параметры и ограничения

ТекстовыйДокумент.УстановитьТипФайла (TextDocument.SetFileType)

ТекстовыйДокумент (TextDocument)

УстановитьТипФайла (SetFileType)

Доступен, начиная с версии 8.0.

Синтаксис:
УстановитьТипФайла(<Тип>)
Параметры:

<Тип> (необязательный)
Тип: КодировкаТекста, Строка.
Устанавливаемый тип файла.

Тип файла может быть задан как в виде значения перечисления КодировкаТекста, так и в виде строки с указанием названия кодировки.
Поддерживаемые названия кодировок:
UTF-8

UTF-16

UTF-16BE

UTF-16LE

ISO-8859-1

US-ASCII

gb18030

iso-8859-2

iso-8859-3

iso-8859-4

iso-8859-5

iso-8859-6

iso-8859-7

iso-8859-8

iso-8859-9

iso-8859-13

iso-8859-15

Shift_JIS

EUC-JP

Big5

Big5-HKSCS

GBK

GB2312

GB_2312-80

EUC-KR

KSC_5601

windows-949

windows-874

cp866

KOI8-R

KOI8-U

windows-1250

windows-1251

windows-1252

windows-1253

windows-1254

windows-1255

windows-1256

windows-1257

windows-1258

macintosh

x-mac-cyrillic

ISO-2022-JP

ISO-2022-KR

ISO-2022-CN

ISO-2022-CN-EXT

HZ-GB-2312

Значение по умолчанию: UTF8.
Описание:

Устанавливает кодировку файла, в которой будет сохранен текстовый документ при интерактивной записи (например, при выборе пункта "Файл - Печать").

Доступность:

Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение.

Использование в версии:

Доступен, начиная с версии 8.0.

Методическая информация

Практические примеры

Собрать и исправить текстовый отчёт по строкам

Редактируем небольшой отчёт в памяти: вставка заголовка, замена ошибочной строки, удаление черновика и добавление подвала.

Где и как запускать

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. Файлы, макеты и реквизиты конфигурации не нужны.

  2. Номера строк ТекстовогоДокумента начинаются с 1, в отличие от индексов Массив.


Документ = Новый ТекстовыйДокумент;
Документ.РазделительСтрок = Символы.ПС;
Документ.УстановитьТекст("Книга: 3" + Символы.ПС + "Ручка: 99" + Символы.ПС + "Черновик");
Документ.ВставитьСтроку(1, "Учебный остаток");
Документ.ЗаменитьСтроку(3, "Ручка: 1");
Документ.УдалитьСтроку(4);
Подвал = Новый ТекстовыйДокумент;
Подвал.ДобавитьСтроку("Всего товаров: 4");
Документ.Вывести(Подвал);
Документ.УстановитьТипФайла(КодировкаТекста.UTF8);
Для Номер = 1 По Документ.КоличествоСтрок() Цикл
    Сообщить(СтрШаблон("%1: %2", Номер, Документ.ПолучитьСтроку(Номер)));
КонецЦикла;
Сообщить(Документ.ПолучитьТекст());
Копия = Новый ТекстовыйДокумент;
Копия.УстановитьТекст(Документ.ПолучитьТекст());
Копия.Очистить();
Сообщить(Копия.ПолучитьТекст() = "");

Разбор по шагам

  1. УстановитьТекст задаёт три строки исходника с известной ошибкой.

  2. Вставка в начало сдвигает номера: Ручка теперь третья строка, Черновик четвёртая.

  3. Заменяем количество, удаляем черновик, добавляем другой текстовый документ методом Вывести.

  4. Обходим строки и читаем полный текст; очищаем отдельную копию, не исходный отчёт.

Как проверить результат

  1. В отчёте есть Учебный остаток, Книга: 3, Ручка: 1 и Всего товаров: 4; слова Черновик нет.

  2. Очищенная копия возвращает пустой текст; исходный документ остаётся заполненным.

  3. Попробуйте номер 0 в ПолучитьСтроку только в учебной базе: это не первая строка.

Ожидаемый результат

Отчёт исправлен в памяти, оригинал и очищенная копия — разные объекты.

На что обратить внимание

  1. После вставки или удаления номера следующих строк меняются.

  2. УстановитьТипФайла задаёт параметры интерактивного сохранения, но сам по себе не создаёт файл.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.