Вставляет узел в список дочерних перед существующим дочерним узлом, заданным параметром <Узел>. Если вставляемый узел является узлом ФрагментДокумента, то все его дочерние узлы будут вставлены перед узлом, заданным параметром <Узел>, в том же порядке. Если узел, заданный параметром <НовыйУзел>, уже содержится в дереве документа, то он сначала удаляется из дочерних узлов прежнего родителя и вставляется в список дочерних узлов нового родителя.
Синтаксис
ВставитьПеред(<НовыйУзел>, <Узел>)Полное описание, параметры и ограничения
ДокументDOM.ВставитьПеред (DOMDocument.InsertBefore)
ДокументDOM (DOMDocument)
ВставитьПеред (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.
Методическая информация
Практические примеры
Добавить технический комментарий и инструкцию обработки XML
Комментарий объясняет учебный файл, а инструкция guide несёт технические данные. Ни один из этих узлов не является товаром.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
Документ = Новый ДокументDOM("", "products");
Комментарий = Документ.СоздатьКомментарий("Учебные данные, не для рабочей загрузки");
Документ.ЭлементДокумента.ДобавитьДочерний(Комментарий);
Инструкция = Документ.СоздатьИнструкциюОбработки("guide", "version=1");
Документ.ВставитьПеред(Инструкция, Документ.ЭлементДокумента);
Сообщить(Комментарий.Данные);
Сообщить(Комментарий.Размер);
Сообщить(Комментарий.ТипУзла);
Сообщить(Комментарий.ИмяУзла);
Сообщить(Комментарий.ДокументВладелец = Документ);
Сообщить(Комментарий.РодительскийУзел = Документ.ЭлементДокумента);
Сообщить(Не Комментарий.ЕстьДочерниеУзлы());
Сообщить(Инструкция.Цель = "guide");
Сообщить(Инструкция.Данные = "version=1");
Сообщить(Инструкция.ИмяУзла);
Сообщить(Инструкция.ТипУзла);
Сообщить(Инструкция.РодительскийУзел = Документ);
Сообщить(Инструкция.СледующийСоседний = Документ.ЭлементДокумента);
Инструкция.Данные = "version=2";
Сообщить(Инструкция.Данные = "version=2");
Запись = Новый ЗаписьXML;
Запись.УстановитьСтроку();
Сериализатор = Новый ЗаписьDOM;
Сериализатор.Записать(Документ, Запись);
Сообщить(Запись.Закрыть());Разбор по шагам
Комментарий создаётся фабрикой документа и становится ребёнком корня products.
Инструкцию guide вставляем перед корнем как ребёнка ДокументDOM. Это не XML-объявление с зарезервированной целью xml.
Цель и Данные инструкции различаются; меняем только данные с version=1 на version=2.
В XML комментарии и инструкции имеют собственный синтаксис. Методы сериализатора оформляют его, а не ручная конкатенация скобок.
Как проверить результат
Родитель комментария — корень products, родитель инструкции — ДокументDOM.
Следующий сосед инструкции — корневой элемент, цель guide сохранилась, данные стали version=2.
Все логические контрольные сообщения Истина; сериализация содержит оба технических узла.
Ожидаемый результат
Разобраны две разновидности нетоварных узлов XML и их место в дереве.
На что обратить внимание
Комментарий не должен содержать --, а данные инструкции — ?>. Этот пример использует только фиксированные допустимые строки.
Не помещайте пароли и токены в комментарии: они тоже попадают в файл XML.
Получатель может игнорировать инструкцию guide; это не договорённость реального протокола.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.