Тип: Строка. Кодировка исходного документа XML. Содержит значение атрибута encoding объявления XML. Если атрибут не указан или объявление не прочитано (отсутствует), то будет возвращена кодировка UTF8.
Полное описание, параметры и ограничения
ЧтениеXML.КодировкаXML (XMLReader.XMLEncoding)
ЧтениеXML (XMLReader)
КодировкаXML (XMLEncoding)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: Строка.
Кодировка исходного документа XML.
Содержит значение атрибута encoding объявления XML.
Если атрибут не указан или объявление не прочитано (отсутствует), то будет возвращена кодировка UTF8.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Поддерживаемые коды кодировок (с учетом правил http://www.w3.org/TR/2004/REC-xml-20040204/#NT-EncName):
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
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Разобрать UTF-8 байты и отдельно прочитать объявление XML
Сначала создаём собственные байты UTF-8 и поток чтения, затем читаем XML-объявление. encoding — текст объявления, КодировкаИсточника — результат определения кодировки байтов.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.
XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.
Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.
Проверки сообщениями ожидают Истина. XML-текст и объекты можно исследовать в отладчике; это не контракт Avito, SOAP или обмен типовой конфигурации.
XML = "<?xml version=""1.0"" encoding=""UTF-8"" standalone=""yes""?><product>Книга</product>";
Данные = ПолучитьДвоичныеДанныеИзСтроки(XML, КодировкаТекста.UTF8);
Поток = Данные.ОткрытьПотокДляЧтения();
Чтение = Новый ЧтениеXML;
Параметры = Новый ПараметрыЧтенияXML("1.0", "", ПробельныеСимволыXML.ПоУмолчанию,
ТипПроверкиXML.НетПроверки, Ложь);
Попытка
Если Параметры.ИгнорироватьОбъявлениеXML Тогда
ВызватьИсключение "Для этого урока нужно чтение объявления XML";
КонецЕсли;
Чтение.ОткрытьПоток(Поток, Параметры, , КодировкаТекста.UTF8);
Если Не Чтение.Прочитать() Тогда
ВызватьИсключение "Нет собственного XML-объявления";
КонецЕсли;
Сообщить(Чтение.ТипУзла = ТипУзлаXML.ОбъявлениеXML);
Сообщить(Чтение.ВерсияXML = "1.0");
Сообщить(Чтение.Автономный);
Сообщить(ВРег(Чтение.КодировкаXML) = "UTF-8");
Сообщить("Определённая кодировка байтов: " + Чтение.КодировкаИсточника);
Если Не Чтение.ПерейтиКСодержимому() Или Чтение.ТипУзла <> ТипУзлаXML.НачалоЭлемента Тогда
ВызватьИсключение "Не найдено начало собственного корня";
КонецЕсли;
Если Не Чтение.Прочитать() Тогда
ВызватьИсключение "Нет текста товара";
КонецЕсли;
Сообщить(Чтение.Значение = "Книга");
Чтение.Закрыть();
Поток.Закрыть();
Исключение
Чтение.Закрыть();
Поток.Закрыть();
ВызватьИсключение;
КонецПопытки;Разбор по шагам
КодировкаТекста.UTF8 создаёт реальные байты из собственной русской строки.
ИгнорироватьОбъявлениеXML=False задано пятым параметром: иначе объявление не является читаемым узлом.
Читаем standalone/version/encoding на объявлении. Имя КодировкаИсточника выводим диагностически, не угадывая написание реализации.
Переходим к корню и проверяем русское слово. Объект чтения и исходный поток закрываем на обоих путях.
Как проверить результат
Пять сравнений Истина и диагностическое имя кодировки источника.
Слово Книга не заменилось «кракозябрами». Файлы не создавались.
Ожидаемый результат
Подтверждён разбор собственных UTF-8 байтов с чтением объявления.
На что обратить внимание
Замена encoding в заголовке не перекодирует уже созданные байты.
standalone=yes — декларация XML, не разрешение отключать проверки безопасности неизвестных входов.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.