Тип: Булево. Содержит признак обхода ссылок на сущности при обходе узлов DOM.
Полное описание, параметры и ограничения
ИтераторУзловDOM.РаскрыватьСсылкиНаСущности (DOMNodeIterator.ExpandEntityReference)
ИтераторУзловDOM (DOMNodeIterator)
РаскрыватьСсылкиНаСущности (ExpandEntityReference)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: Булево.
Содержит признак обхода ссылок на сущности при обходе узлов DOM.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Истина - при обходе узла ссылки на сущность будет производиться обход узлов содержимого сущности, в противном случае обход производиться не будет.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Последовательно обойти DOM, включая текстовые узлы
Итератор видит не только товары, но и корень и текстовые узлы. Обходим вперёд до конца, возвращаемся назад и освобождаем итератор.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
Документ = Новый ДокументDOM("", "products");
Корень = Документ.ЭлементДокумента;
Для Номер = 1 По 2 Цикл
Товар = Документ.СоздатьЭлемент("product");
Товар.УстановитьАтрибут("code", ?(Номер = 1, "A-01", "B-02"));
Товар.ДобавитьДочерний(Документ.СоздатьТекстовыйУзел(?(Номер = 1, "Книга", "Ручка")));
Корень.ДобавитьДочерний(Товар);
КонецЦикла;
Итератор = Документ.СоздатьИтераторУзлов(Корень, , Ложь);
Сообщить(Итератор.Корень = Корень);
Сообщить(Не Итератор.РаскрыватьСсылкиНаСущности);
Пройдено = 0;
Узел = Итератор.СледующийУзел();
Пока Узел <> Неопределено Цикл
Пройдено = Пройдено + 1;
Сообщить(СтрШаблон("%1: %2; тип %3", Пройдено, Узел.ИмяУзла, Узел.ТипУзла));
Узел = Итератор.СледующийУзел();
КонецЦикла;
Сообщить(Пройдено = 5);
Последний = Итератор.ПредыдущийУзел();
Если Последний = Неопределено Тогда
ВызватьИсключение "Не найден последний узел учебного дерева";
КонецЕсли;
Сообщить(Последний.ТекстовоеСодержимое = "Ручка");
Итератор.Отсоединить();
Сообщить("Итератор отсоединён: дальнейшие методы обхода не вызываются");Разбор по шагам
Корень итератора ограничивает область обхода деревом products. В учебном документе два товара и два текстовых ребёнка.
Отбор не передаём, поэтому обход включает и элементы, и текст. Начальная позиция позволяет первым получить корень.
СледующийУзел возвращает Неопределено после конца. ПредыдущийУзел позволяет вернуться к последнему пройденному узлу.
Отсоединить освобождает итератор. После этого объект не используем для нового обхода.
Как проверить результат
Порядок узлов: products, product, текст Книга, product, текст Ручка; всего 5.
После обратного шага текстовое содержимое равно Ручка.
Сравнение корня и проверка РаскрыватьСсылкиНаСущности дают Истина.
Ожидаемый результат
Разобран последовательный DOM-обход с текстовыми узлами и завершением работы итератора.
На что обратить внимание
Красиво оформленный разобранный XML может иметь дополнительные пробельные текстовые узлы, поэтому количество 5 относится только к построенному дереву.
Не путайте ИтераторУзловDOM с результатом-итератором XPath: это разные объекты и методы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.