Тип: ТипПроверкиXML. Содержит тип проверки данных XML на правильность при чтении. Значение по умолчанию НетПроверки.
Полное описание, параметры и ограничения
ПараметрыЧтенияXML.ТипПроверкиПравильности (XMLReaderSettings.ValidationType)
ПараметрыЧтенияXML (XMLReaderSettings)
ТипПроверкиПравильности (ValidationType)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: ТипПроверкиXML.
Содержит тип проверки данных XML на правильность при чтении. Значение по умолчанию НетПроверки.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Различить явный code и подставленный DTD-атрибут kind
Собственный внутренний DTD требует code и задаёт kind=paper по умолчанию. Проверка DTD включена; на каждом атрибуте читается происхождение значения.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.
XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.
Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.
Проверки сообщениями ожидают Истина. XML-текст и объекты можно исследовать в отладчике; это не контракт Avito, SOAP или обмен типовой конфигурации.
XML = "<!DOCTYPE product [<!ELEMENT product (#PCDATA)><!ATTLIST product code CDATA #REQUIRED kind CDATA ""paper""><!ENTITY guide ""Книга""><!NOTATION png SYSTEM ""urn:guide:format:png""><!ENTITY picture SYSTEM ""urn:guide:picture"" NDATA png>]><product code=""A-01"">Книга</product>";
Параметры = Новый ПараметрыЧтенияXML("1.0", "", ПробельныеСимволыXML.ПоУмолчанию, ТипПроверкиXML.ОпределениеТипаДокумента, Истина, Ложь);
Чтение = Новый ЧтениеXML;
Попытка
Чтение.УстановитьСтроку(XML, Параметры);
Если Параметры.ТипПроверкиПравильности <> ТипПроверкиXML.ОпределениеТипаДокумента
Или Параметры.ИгнорироватьТипДокумента Тогда
ВызватьИсключение "Для этого урока нужна проверка собственного DTD";
КонецЕсли;
Если Не Чтение.ПерейтиКСодержимому() Или Чтение.ТипУзла <> ТипУзлаXML.НачалоЭлемента Тогда
ВызватьИсключение "Не найдено начало собственного корня";
КонецЕсли;
ЕстьЯвный = Ложь;
ЕстьПоУмолчанию = Ложь;
Пока Чтение.ПрочитатьАтрибут() Цикл
Если Чтение.Имя = "code" Тогда
ЕстьЯвный = Истина;
Сообщить(Чтение.Значение = "A-01" И Не Чтение.ЭтоАтрибутПоУмолчанию);
ИначеЕсли Чтение.Имя = "kind" Тогда
ЕстьПоУмолчанию = Истина;
Сообщить(Чтение.Значение = "paper" И Чтение.ЭтоАтрибутПоУмолчанию);
КонецЕсли;
КонецЦикла;
Сообщить(ЕстьЯвный И ЕстьПоУмолчанию);
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;Разбор по шагам
Включаем проверку DTD только для приведённой собственной строки без внешних источников.
ПерейтиКСодержимому пропускает DTD и доводит до product, не до его первого атрибута.
Явный code и подставленный kind проверяем по имени и ЭтоАтрибутПоУмолчанию.
Оба атрибута возвращают строки: происхождение и лексическое значение проверяются отдельно.
Как проверить результат
Три сравнения Истина.
Добавьте kind="paper" непосредственно в product: значение прежнее, происхождение default станет Ложь.
Удалите обязательный code: ожидается ошибка DTD-проверки, не успешное заполнение товара.
Ожидаемый результат
Показано отличие происхождения одинакового значения атрибута.
На что обратить внимание
Не обещайте DTD-проверку при ТипПроверкиXML.НетПроверки.
Подставленное значение схемы не доказывает, что поставщик прислал поле явно.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Сравнить параметры по умолчанию и фильтрацию PI/комментария/CDATA
Два прохода одного XML показывают, что инструкция обработки — данные, комментарий можно пропустить, а CDATA можно представить текстом без потери угловых скобок.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.
XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.
Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.
Проверки сообщениями ожидают Истина. XML-текст и объекты можно исследовать в отладчике; это не контракт Avito, SOAP или обмен типовой конфигурации.
XML = "<?xml version=""1.0""?><?guide mode=""training""?><catalog><!-- учебные данные --><product><![CDATA[Книга <учебник>]]></product></catalog>";
Параметры = Новый ПараметрыЧтенияXML;
Чтение = Новый ЧтениеXML;
Попытка
Чтение.УстановитьСтроку(XML, Параметры);
ПараметрыПоУмолчанию = Чтение.Параметры;
Сообщить(ПараметрыПоУмолчанию.Версия = "1.0");
Сообщить(ПараметрыПоУмолчанию.Язык = "");
Сообщить(ПараметрыПоУмолчанию.ПробельныеСимволы = ПробельныеСимволыXML.ПоУмолчанию);
Сообщить(ПараметрыПоУмолчанию.ТипПроверкиПравильности = ТипПроверкиXML.НетПроверки);
Сообщить(ПараметрыПоУмолчанию.ИгнорироватьОбъявлениеXML);
Сообщить(ПараметрыПоУмолчанию.ИгнорироватьТипДокумента);
Сообщить(ПараметрыПоУмолчанию.ИгнорироватьПробельныеСимволы);
Сообщить(Не ПараметрыПоУмолчанию.ИгнорироватьИнструкцииОбработки);
Сообщить(Не ПараметрыПоУмолчанию.ИгнорироватьКомментарии);
Сообщить(Не ПараметрыПоУмолчанию.СекцииCDATAКакТекст);
Сообщить(Не ПараметрыПоУмолчанию.ИспользоватьИгнорируемыеПробельныеСимволы);
ПараметрыФильтра = Новый ПараметрыЧтенияXML("1.0", "", ПробельныеСимволыXML.ПоУмолчанию,
ТипПроверкиXML.НетПроверки, Истина, Истина, Истина, Истина, Истина, Истина, Ложь);
Для НомерПрохода = 1 По 2 Цикл
Если НомерПрохода = 1 Тогда
Чтение.УстановитьСтроку(XML, ПараметрыПоУмолчанию);
Иначе
Чтение.УстановитьСтроку(XML, ПараметрыФильтра);
КонецЕсли;
Комментариев = 0;
Инструкций = 0;
Секций = 0;
Текст = "";
Пока Чтение.Прочитать() Цикл
Если Чтение.ТипУзла = ТипУзлаXML.Комментарий Тогда
Комментариев = Комментариев + 1;
ИначеЕсли Чтение.ТипУзла = ТипУзлаXML.ИнструкцияОбработки Тогда
Инструкций = Инструкций + 1;
ИначеЕсли Чтение.ЭтоСимвольныеДанные Тогда
Текст = Текст + Чтение.Значение;
Если Чтение.ТипУзла = ТипУзлаXML.СекцияCDATA Тогда
Секций = Секций + 1;
КонецЕсли;
КонецЕсли;
КонецЦикла;
Если НомерПрохода = 1 Тогда
Сообщить(Комментариев = 1 И Инструкций = 1 И Секций = 1);
Иначе
Сообщить(Комментариев = 0 И Инструкций = 0 И Секций = 0);
КонецЕсли;
Сообщить(Текст = "Книга <учебник>");
КонецЦикла;
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;Разбор по шагам
Сначала читаем одиннадцать свойств реальных параметров по умолчанию.
Параметры неизменяемы: другой режим задаётся отдельным конструктором с одиннадцатью позициями.
Первый проход видит PI, комментарий и отдельную секцию. Второй пропускает PI/комментарий, CDATA превращает в текст.
Ни в одном проходе инструкция guide не выполняется; оба прохода сохраняют собственный текст.
Как проверить результат
Пятнадцать сравнений Истина: одиннадцать настроек и четыре проверки двух проходов.
Текст сохраняется как Книга <учебник>, без создания вложенного элемента учебник.
Ожидаемый результат
Проверена фильтрация потока узлов с сохранением полезного текста.
На что обратить внимание
НетПроверки не означает принятие синтаксически повреждённого XML; это отсутствие проверки DTD/XSD.
CDATA не является HTML и не требует исполнять или отображать её как разметку.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.