ЗаписьHTML.ОткрытьФайл

Методы · OpenFile

Открывает файл для записи HTML. Позволяет указать тип кодировки, который будет использован для записи файла HTML.

Синтаксис

ОткрытьФайл(<ИмяФайлаHTML>, <ТипКодировки>)
ОткрытьФайл(<ИмяФайлаHTML>, <ПараметрыЗаписи>)

Примеры платформы

ЗаписьHTML = Новый ЗаписьHTML;
ЗаписьHTML.ОткрытьФайл("c:\docs\data.html", "UTF-8");
Полное описание, параметры и ограничения

ЗаписьHTML.ОткрытьФайл (HTMLWriter.OpenFile)

ЗаписьHTML (HTMLWriter)

ОткрытьФайл (OpenFile)

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

Вариант синтаксиса: По имени и типу кодировки

Синтаксис:
ОткрытьФайл(<ИмяФайлаHTML>, <ТипКодировки>)
Параметры:

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

<ТипКодировки> (необязательный)
Тип: Строка.
В качестве типа кодировки может быть указана одна из возможных кодировок текста. В этом случае файл будет записан в соответствующей кодировке. При этом в объявлении HTML-документа (если таковое будет записано) будет присутствовать атрибут 'encoding', имеющий соответствующее значение. Если же в качестве параметра указана пустая строка или ничего не указано, то для записи файла будет использована кодировка UTF8, а атрибут 'encoding' не будет присутствовать в объявлении HTML-документа.
Поддерживаемые коды кодировок:
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

Вариант синтаксиса: С параметрами записи

Синтаксис:
ОткрытьФайл(<ИмяФайлаHTML>, <ПараметрыЗаписи>)
Параметры:

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

<ПараметрыЗаписи> (обязательный)
Тип: ПараметрыЗаписиXML.
Параметры записи XML.
Описание:

Открывает файл для записи HTML. Позволяет указать тип кодировки, который будет использован для записи файла HTML.

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

Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Пример:

ЗаписьHTML = Новый ЗаписьHTML;
ЗаписьHTML.ОткрытьФайл("c:\docs\data.html", "UTF-8");

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

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

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

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

Записать и прочитать только собственный временный HTML-файл

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

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

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

Подготовка

  1. Используйте учебную базу платформы 8.5.1.1343 и серверную процедуру учебного общего модуля. Каждый пример выполняйте отдельно.

  2. Все данные заказа вымышлены и находятся в строке. ЧтениеHTML разбирает данные, но не является браузером: форма не отправляется, ссылки не открываются, картинки не скачиваются.

  3. Только этот файловый урок создаёт и удаляет один новый временный HTML-файл на машине выполнения. Не подменяйте генерируемое имя существующим файлом.

  4. Нужны права записи и удаления в собственной временной папке. Код сначала выводит точный путь для ручной уборки, если ресурсная ошибка помешает удалению.

  5. Индексы коллекций начинаются с нуля. Перед обращением к найденному узлу проверяйте Неопределено; перед специальными свойствами элемента проверяйте его тип.

HTML = "<html><head><title>Учебный заказ</title><meta id='meta' name='description' content='Вымышленный заказ'></head>
|<body id='body'><p id='note'>Заказ существует только в памяти</p><pre id='code'>A-01: 3
|B-02: 1</pre>
|<form id='order' name='order' action='' method='get'>
|<input id='customer' name='customer' type='text' value='Учебный покупатель'>
|<input id='accepted' name='accepted' type='checkbox' value='yes'>
|<button id='preview' name='preview' type='button' value='preview'>Предпросмотр</button></form>
|<table id='items' summary='Книга и ручка'><caption id='caption'>Товары</caption><colgroup><col id='column'></colgroup><tbody>
|<tr id='book'><td id='book-name'>Книга</td><td>3</td></tr><tr id='pen'><td>Ручка</td><td>1</td></tr>
|</tbody></table><a id='help' name='help' href='#note'>Пояснение</a><img id='logo' alt='Учебная картинка без источника'>
|</body></html>";
Чтение = Новый ЧтениеHTML;
Чтение.УстановитьСтроку(HTML);
Попытка
    Построитель = Новый ПостроительDOM;
    Документ = Построитель.Прочитать(Чтение);
Исключение
    Чтение.Закрыть();
    ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Если ТипЗнч(Документ) <> Тип("ДокументHTML") Тогда
    ВызватьИсключение "Ожидался ДокументHTML, а не XML-документ";
КонецЕсли;
ИмяУчебногоФайла = ПолучитьИмяВременногоФайла("html");
Сообщить("Создаваемый учебный файл: " + ИмяУчебногоФайла);
ЗаписьФайла = Новый ЗаписьHTML;
ЧтениеФайла = Новый ЧтениеHTML;
ЗаписьОткрыта = Ложь;
ЧтениеОткрыто = Ложь;
Попытка
    ЗаписьФайла.ОткрытьФайл(ИмяУчебногоФайла, "UTF-8");
    ЗаписьОткрыта = Истина;
    ЗаписьДерева = Новый ЗаписьDOM;
    ЗаписьДерева.Записать(Документ, ЗаписьФайла);
    СтроковыйРезультат = ЗаписьФайла.Закрыть();
    ЗаписьОткрыта = Ложь;
    Сообщить(СтроковыйРезультат = "");
    ЧтениеФайла.ОткрытьФайл(ИмяУчебногоФайла, "UTF-8");
    ЧтениеОткрыто = Истина;
    Копия = Построитель.Прочитать(ЧтениеФайла);
    ЧтениеФайла.Закрыть();
    ЧтениеОткрыто = Ложь;
Исключение
    Если ЧтениеОткрыто Тогда
        ЧтениеФайла.Закрыть();
    КонецЕсли;
    Если ЗаписьОткрыта Тогда
        ЗаписьФайла.Закрыть();
    КонецЕсли;
    УчебныйФайл = Новый Файл(ИмяУчебногоФайла);
    Если УчебныйФайл.Существует() Тогда
        УдалитьФайлы(ИмяУчебногоФайла);
    КонецЕсли;
    ВызватьИсключение;
КонецПопытки;
УдалитьФайлы(ИмяУчебногоФайла);
УчебныйФайл = Новый Файл(ИмяУчебногоФайла);
Сообщить(Не УчебныйФайл.Существует());
Если ТипЗнч(Копия) <> Тип("ДокументHTML") Тогда
    ВызватьИсключение "Ожидался собственный HTML-документ из временного файла";
КонецЕсли;
Сообщить(Копия.Заголовок = "Учебный заказ");
Сообщить(Копия.Формы.Количество() = 1);

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

  1. Имя генерируется платформой с расширением html; не заменяйте его чужим файлом или маской.

  2. В серверной процедуре путь относится к машине сервера, не обязательно к компьютеру пользователя.

  3. Закрыть при записи в файл возвращает пустую строку, а не содержимое HTML.

  4. Читаем тот же файл в явно заданной UTF-8, закрываем ресурсы и удаляем только точное сгенерированное имя.

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

  1. Четыре проверки Истина: пустой строковый результат записи, отсутствие временного файла после удаления, заголовок и одна форма.

  2. При ошибке чтения удаляется тот же учебный файл; реальное руководство или другие файлы не выбираются кодом.

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

Показан файловый обмен с контролируемым сроком жизни собственного временного файла.

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

  1. В отличие от остальных HTML-уроков, запуск этого упражнения действительно создаёт и удаляет один временный файл.

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

  3. Пустой результат Закрыть файловой записи не означает пустой файл.

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

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

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

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

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