Вставляет узел в список дочерних перед существующим дочерним узлом, заданным параметром <Узел>. Если вставляемый узел является узлом ФрагментДокумента, то все его дочерние узлы будут вставлены перед узлом, заданным параметром <Узел>, в том же порядке. Если узел, заданный параметром <НовыйУзел>, уже содержится в дереве документа, то он сначала удаляется из дочерних узлов прежнего родителя и вставляется в список дочерних узлов нового родителя.
Синтаксис
ВставитьПеред(<НовыйУзел>, <Узел>)Полное описание, параметры и ограничения
ОпределениеТипаДокументаDOM.ВставитьПеред (DOMDocumentType.InsertBefore)
ОпределениеТипаДокументаDOM (DOMDocumentType)
ВставитьПеред (InsertBefore)
Доступен, начиная с версии 8.1.
Синтаксис:
ВставитьПеред(<НовыйУзел>, <Узел>)
Параметры:
<НовыйУзел> (обязательный)
Тип: АтрибутDOM, ДокументDOM, ЭлементDOM, ОпределениеТипаДокументаDOM, НотацияDOM, СущностьDOM, ФрагментДокументаDOM, ТекстDOM, КомментарийDOM, СекцияCDATADOM, ИнструкцияОбработкиDOM, СсылкаНаСущностьDOM, ПространствоИменXPath.
Вставляемый узел DOM.
<Узел> (обязательный)
Тип: АтрибутDOM, ДокументDOM, ЭлементDOM, ОпределениеТипаДокументаDOM, НотацияDOM, СущностьDOM, ФрагментДокументаDOM, ТекстDOM, КомментарийDOM, СекцияCDATADOM, ИнструкцияОбработкиDOM, СсылкаНаСущностьDOM, ПространствоИменXPath.
Узел, перед которым необходимо вставить узел, заданный в параметре <НовыйУзел>.
Если параметр не задан, то узел добавляется к концу списка дочерних узлов.
Возвращаемое значение:
Тип: АтрибутDOM, ДокументDOM, ЭлементDOM, ОпределениеТипаДокументаDOM, НотацияDOM, СущностьDOM, ФрагментДокументаDOM, ТекстDOM, КомментарийDOM, СекцияCDATADOM, ИнструкцияОбработкиDOM, СсылкаНаСущностьDOM, ПространствоИменXPath.
Описание:
Вставляет узел в список дочерних перед существующим дочерним узлом, заданным параметром <Узел>.
Если вставляемый узел является узлом ФрагментДокумента, то все его дочерние узлы будут вставлены перед узлом, заданным параметром <Узел>, в том же порядке. Если узел, заданный параметром <НовыйУзел>, уже содержится в дереве документа, то он сначала удаляется из дочерних узлов прежнего родителя и вставляется в список дочерних узлов нового родителя.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Причины вызова исключения:
данный узел не допускает в качестве дочерних добавляемый узел или добавляемый узел является одним из предков данного или узел добавляется сам в себя или данный узел Документ и добавляется второй узел ОпределениеТипаДокумента или Элемент;
добавляемый узел был создан документом отличным от создавшего данный узел;
данный узел в режиме Только для чтения или если предыдущий родитель добавляемого узла в режиме Только для чтения;
узел, перед которым осуществляется вставка, не найден.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Проверить, почему DOCTYPE нельзя заполнить элементами product
Определение типа не контейнер XML-элементов. Четыре операции над собственным новым элементом намеренно отклоняются; вывод ошибки объясняет ограничение API.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
DOCTYPE создан собственным конструктором с пустыми PUBLIC/SYSTEM. Внутренних сущностей/нотаций нет; guideProduct — намеренно неопределённая ссылка, а не загруженный товар.
Этот документ исследуется только в памяти. Не сохраняйте и не передавайте его как готовый XML обмена: ссылка guideProduct не объявлена.
XPath namespace::g возвращает специализированный узел, а не строку URI и не обычный атрибут xmlns.
ОписаниеТипа = Новый ОпределениеТипаДокументаDOM("products", "", "");
Документ = Новый ДокументDOM("urn:guide:special", "g:products", ОписаниеТипа);
Корень = Документ.ЭлементДокумента;
Корень.УстановитьСоответствиеПространстваИмен("g", "urn:guide:special");
Ссылка = Документ.СоздатьСсылкуНаСущность("guideProduct");
Корень.ДобавитьДочерний(Ссылка);
Разыменователь = Документ.СоздатьРазыменовательПИ();
Результат = Документ.ВычислитьВыражениеXPath("namespace::g", Корень,
Разыменователь, ТипРезультатаDOMXPath.НеупорядоченныйСнимокУзлов);
Если Результат.РазмерСнимка <> 1 Тогда
ВызватьИсключение "Ожидался ровно один собственный namespace g";
КонецЕсли;
Пространство = Результат.ЭлементСнимка(0);
Если ТипЗнч(Пространство) <> Тип("ПространствоИменXPath") Тогда
ВызватьИсключение "Ожидался настоящий узел ПространствоИменXPath";
КонецЕсли;
Узлы = Новый Массив;
Узлы.Добавить(ОписаниеТипа);
Узлы.Добавить(Ссылка);
Узлы.Добавить(Пространство);
Кандидат = Документ.СоздатьЭлемент("ownChild");
Отказов = 0;
Попытка
ОписаниеТипа.ДобавитьДочерний(Кандидат);
Исключение
Отказов = Отказов + 1;
Сообщить("Ожидаемое ограничение: " + ОписаниеОшибки());
КонецПопытки;
Попытка
ОписаниеТипа.ВставитьПеред(Кандидат, Кандидат);
Исключение
Отказов = Отказов + 1;
Сообщить("Ожидаемое ограничение: " + ОписаниеОшибки());
КонецПопытки;
Попытка
ОписаниеТипа.ЗаменитьДочерний(Кандидат, Кандидат);
Исключение
Отказов = Отказов + 1;
Сообщить("Ожидаемое ограничение: " + ОписаниеОшибки());
КонецПопытки;
Попытка
ОписаниеТипа.УдалитьДочерний(Кандидат);
Исключение
Отказов = Отказов + 1;
Сообщить("Ожидаемое ограничение: " + ОписаниеОшибки());
КонецПопытки;
Сообщить(Отказов = 4);
Сообщить(ОписаниеТипа.ДочерниеУзлы.Количество() = 0);
Сообщить(Кандидат.РодительскийУзел = Неопределено);Разбор по шагам
Создаём неприкреплённый ownChild в том же собственном документе.
Добавление/вставка не разрешены видом узла; замена/удаление также не находят указанного ребёнка.
Каждая ошибка перехватывается отдельно, затем проверяются счётчик отказов и неизменность дерева.
Как проверить результат
Четыре сообщения об ожидаемых ограничениях и Отказов = 4.
DOCTYPE по-прежнему без дочерних узлов; кандидат не получил родителя. Два последних сравнения Истина.
Ожидаемый результат
Четыре отрицательные проверки не превратили DOCTYPE в контейнер товаров.
На что обратить внимание
Это демонстрация недопустимых действий, а не рецепт редактирования DTD.
Правильное место для product — ЭлементДокумента, а не ОпределениеТипаДокумента.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.