Сравнивает данный узел с узлом, переданным в качестве параметра, для определения позиции относительно документа.
Синтаксис
СравнитьПозициюВДокументе(<Узел>)Полное описание, параметры и ограничения
ФрагментДокументаDOM.СравнитьПозициюВДокументе (DOMDocumentFragment.CompareDocumentPosition)
ФрагментДокументаDOM (DOMDocumentFragment)
СравнитьПозициюВДокументе (CompareDocumentPosition)
Доступен, начиная с версии 8.1.
Синтаксис:
СравнитьПозициюВДокументе(<Узел>)
Параметры:
<Узел> (обязательный)
Тип: АтрибутDOM, ДокументDOM, ЭлементDOM, ОпределениеТипаДокументаDOM, НотацияDOM, СущностьDOM, ФрагментДокументаDOM, ТекстDOM, КомментарийDOM, СекцияCDATADOM, ИнструкцияОбработкиDOM, СсылкаНаСущностьDOM, ПространствоИменXPath.
Узел DOM, с которым происходит сравнение.
Возвращаемое значение:
Тип: ПозицияВДокументеDOM.
Описание:
Сравнивает данный узел с узлом, переданным в качестве параметра, для определения позиции относительно документа.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Сравнить расположение обычных узлов относительно корня XML
На восьми реальных видах узлов читаем ответ платформы и отдельно проверяем идентичность. Отсоединённый фрагмент не превращается в часть дерева из-за общего документа-владельца.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
Документ = Новый ДокументDOM("urn:guide:nodes", "g:guide");
Корень = Документ.ЭлементДокумента;
Корень.УстановитьСоответствиеПространстваИмен("g", "urn:guide:nodes");
Атрибут = Документ.СоздатьАтрибут("code");
Атрибут.Значение = "A-01";
Корень.УстановитьУзелАтрибута(Атрибут);
Текст = Документ.СоздатьТекстовыйУзел("Книга");
Комментарий = Документ.СоздатьКомментарий("учебный комментарий");
CDATA = Документ.СоздатьСекциюCDATA("<данные>");
Инструкция = Документ.СоздатьИнструкциюОбработки("guide", "mode=test");
Корень.ДобавитьДочерний(Текст);
Корень.ДобавитьДочерний(Комментарий);
Корень.ДобавитьДочерний(CDATA);
Корень.ДобавитьДочерний(Инструкция);
Фрагмент = Документ.СоздатьФрагментДокумента();
Фрагмент.ДобавитьДочерний(Документ.СоздатьЭлемент("note"));
Узлы = Новый Массив;
Узлы.Добавить(Документ);
Узлы.Добавить(Корень);
Узлы.Добавить(Атрибут);
Узлы.Добавить(Текст);
Узлы.Добавить(Комментарий);
Узлы.Добавить(CDATA);
Узлы.Добавить(Инструкция);
Узлы.Добавить(Фрагмент);
Для Каждого Узел Из Узлы Цикл
Сообщить(Узел.ТипУзла);
Сообщить(Узел.СравнитьПозициюВДокументе(Корень));
Сообщить(Узел.УзелИдентичен(Корень));
КонецЦикла;
Сообщить(Корень.УзелИдентичен(Корень));
Сообщить(Документ.УзелИдентичен(Корень) = Ложь);
Сообщить(Фрагмент.РодительскийУзел = Неопределено);
Сообщить(Фрагмент.ДокументВладелец = Документ);Разбор по шагам
Получаем документ, корень, атрибут, текст, комментарий, CDATA, инструкцию и отсоединённый фрагмент.
Для каждого выводим позицию относительно корня. Не обещаем одно фиксированное значение для атрибута или отсоединённого фрагмента.
Проверки идентичности и связей независимы от позиции: только сам корень идентичен корню.
Как проверить результат
В восьми итерациях УзелИдентичен(Корень) истинен только для строки ЭлементDOM.
Четыре финальных сравнения Истина. Фрагмент не присоединён к дереву.
Ожидаемый результат
На настоящем дереве показан API сравнения позиции восьми видов узлов.
На что обратить внимание
Позиция не является порядковым номером DOM-узла или массива.
Общий ДокументВладелец не гарантирует общего родителя и не доказывает присоединение узла.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.