Тип: Строка. Кодировка, в которой записан документ (информация имеется на момент разбора). Пустая строка, если кодировка неизвестна (например, документ формируется в памяти).
Полное описание, параметры и ограничения
ДокументDOM.КодировкаИсточника (DOMDocument.InputEncoding)
ДокументDOM (DOMDocument)
КодировкаИсточника (InputEncoding)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: Строка.
Кодировка, в которой записан документ (информация имеется на момент разбора).
Пустая строка, если кодировка неизвестна (например, документ формируется в памяти).
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Задать свойства XML-документа, не выдавая их за преобразование кодировки
Документ в памяти имеет версию и признак автономности, но не имеет исходной байтовой кодировки. ЗаписьDOM создаёт строку, а не файл UTF-8.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документ создаётся в памяти без DTD, схемы, HTTP и файлов.
URI urn:guide:memory-document — условный идентификатор; он не загружается из интернета.
Документ = Новый ДокументDOM("", "guide");
Документ.ВерсияXML = "1.0";
Документ.Автономный = Истина;
Документ.URIДокумента = "urn:guide:memory-document";
Документ.ЭлементДокумента.ТекстовоеСодержимое = "Книга";
Сообщить(Документ.ВерсияXML = "1.0");
Сообщить(Документ.Автономный);
Сообщить(Документ.URIДокумента = "urn:guide:memory-document");
Сообщить(Документ.КодировкаИсточника = "");
Сообщить(Документ.КодировкаXML = "");
Сообщить(Документ.ОпределениеТипаДокумента = Неопределено);
Запись = Новый ЗаписьXML;
Запись.УстановитьСтроку();
Попытка
ЗаписьДерева = Новый ЗаписьDOM;
ЗаписьДерева.Записать(Документ, Запись);
XML = Запись.Закрыть();
Исключение
Запись.Закрыть();
ВызватьИсключение;
КонецПопытки;
Сообщить(XML);
Сообщить(СтрНайти(XML, "Книга") > 0);Разбор по шагам
ВерсияXML 1.0 определяет правила XML. Автономный — декларация независимости от внешних определений, а не запрет сети во всём приложении.
URIДокумента задаёт идентификатор документа, не сохраняет файл и не запускает запрос.
КодировкаИсточника и КодировкаXML доступны только для чтения. У созданного в памяти документа они пустые: источника байтов не было.
Через ЗаписьDOM и ЗаписьXML сериализуем дерево в строку. Кодирование этой строки в байты или файл — отдельный шаг.
Как проверить результат
Версия 1.0, Автономный=Истина и заданный URI читаются обратно; оба свойства кодировки пустые.
ОпределениеТипаДокумента отсутствует, XML содержит Книга.
Нет создания файла по URI и загрузки внешних определений.
Ожидаемый результат
Свойства декларации, идентификатор и происхождение кодировки отделены от сериализации строки.
На что обратить внимание
Установка URI не доказывает наличие ресурса по этому адресу.
Нельзя назначить КодировкаXML напрямую: выбирайте нужную кодировку при записи в файл или преобразовании в двоичные данные.
Автономный=Истина не является средством защиты от загрузки внешних XML-ресурсов в другом коде.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.