Заменяет дочерний узел, указанный параметром <СтарыйУзел>, на узел, указанный параметром <НовыйУзел>. Если новый узел - это ФрагментДокумента, то заменяемый узел будет заменен всеми дочерними узлами фрагмента документа. Если новый узел уже содержится в дереве документа, то он сначала удаляется из дочерних узлов старого родителя и вставляется в список дочерних узлов нового родителя.
Синтаксис
ЗаменитьДочерний(<НовыйУзел>, <СтарыйУзел>)Полное описание, параметры и ограничения
ФрагментДокументаDOM.ЗаменитьДочерний (DOMDocumentFragment.ReplaceChild)
ФрагментДокументаDOM (DOMDocumentFragment)
ЗаменитьДочерний (ReplaceChild)
Доступен, начиная с версии 8.1.
Синтаксис:
ЗаменитьДочерний(<НовыйУзел>, <СтарыйУзел>)
Параметры:
<НовыйУзел> (обязательный)
Тип: Атрибут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.
Существующий дочерний узел.
Возвращаемое значение:
Тип: АтрибутDOM, ДокументDOM, ЭлементDOM, ОпределениеТипаДокументаDOM, НотацияDOM, СущностьDOM, ФрагментДокументаDOM, ТекстDOM, КомментарийDOM, СекцияCDATADOM, ИнструкцияОбработкиDOM, СсылкаНаСущностьDOM, ПространствоИменXPath.
Значение прежнего узла.
Описание:
Заменяет дочерний узел, указанный параметром <СтарыйУзел>, на узел, указанный параметром <НовыйУзел>.
Если новый узел - это ФрагментДокумента, то заменяемый узел будет заменен всеми дочерними узлами фрагмента документа.
Если новый узел уже содержится в дереве документа, то он сначала удаляется из дочерних узлов старого родителя и вставляется в список дочерних узлов нового родителя.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Исключение генерируется в случаях:
если данный узел не допускает в качестве дочерних добавляемый узел или добавляемый узел является одним из предков данного;
если узел добавляется сам в себя;
если данный узел - Документ и добавляется второй узел ОпределениеТипаДокумента или Элемент;
если добавляемый узел был создан документом отличным от создавшего данный узел;
если данный узел в режиме только для чтения или если предыдущий родитель добавляемого узла в режиме Только для чтения;
если заменяемый узел не найден;
если добавляемый узел является дочерним узлом узла Документ и реализация не поддерживает удаления узлов ОпределениеТипаДокумента и Элемент у узла Документ.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Подготовить XML-фрагмент: порядок, замена и удаление до включения в документ
Фрагмент — временный контейнер узлов. Все изменения делаем в нём, затем одной операцией переносим его детей в products.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
Преобразования выполняются только над собственным XML в памяти. Примеры не читают файлы, внешние DTD, URL или данные информационной базы.
У методов DOM возвращаемый узел сохраняйте в переменную: исходная ссылка и результат операции не всегда обозначают один объект.
Документ = Новый ДокументDOM("", "products");
Фрагмент = Документ.СоздатьФрагментДокумента();
Первый = Документ.СоздатьЭлемент("book");
Последний = Документ.СоздатьЭлемент("pen");
Фрагмент.ДобавитьДочерний(Последний);
Фрагмент.ВставитьПеред(Первый, Последний);
Временный = Документ.СоздатьЭлемент("draft");
Фрагмент.ВставитьПеред(Временный, Последний);
Замена = Документ.СоздатьЭлемент("tea");
Возвращённый = Фрагмент.ЗаменитьДочерний(Замена, Временный);
Сообщить(Возвращённый.УзелИдентичен(Временный));
Сообщить(Временный.РодительскийУзел = Неопределено);
Фрагмент.УдалитьДочерний(Замена);
Фрагмент.ДобавитьДочерний(Документ.СоздатьТекстовыйУзел("Кни"));
Фрагмент.ДобавитьДочерний(Документ.СоздатьТекстовыйУзел("га"));
Сообщить(Фрагмент.ДочерниеУзлы.Количество() = 4);
Фрагмент.Нормализовать();
Сообщить(Фрагмент.ДочерниеУзлы.Количество() = 3);
Сообщить(Фрагмент.ПервыйДочерний.ИмяЭлемента = "book");
Сообщить(Фрагмент.ДочерниеУзлы.Элемент(1).ИмяЭлемента = "pen");
Сообщить(Фрагмент.ПоследнийДочерний.ТекстовоеСодержимое = "Книга");
Документ.ЭлементДокумента.ДобавитьДочерний(Фрагмент);
Сообщить(Документ.ЭлементДокумента.ДочерниеУзлы.Количество() = 3);
Сообщить(Фрагмент.ДочерниеУзлы.Количество() = 0);Разбор по шагам
ВставитьПеред ставит book перед уже имеющимся pen. Затем между ними вставляем draft.
ЗаменитьДочерний меняет draft на tea и возвращает старый draft. УдалитьДочерний отсоединяет tea; остаются book и pen.
Добавляем два соседних текстовых узла Кни и га. Нормализовать объединяет их в один текст Книга, оставляя порядок элементов.
Присоединение ФрагментДокументаDOM переносит его детей к products, не создавая обёртку fragment. Временный контейнер становится пустым.
Как проверить результат
Все девять логических сообщений дают Истина.
До нормализации четыре ребёнка, после — три: book, pen, текст Книга. У products после присоединения те же три ребёнка.
draft и tea не попадают в готовый XML, фрагмент после переноса пуст.
Ожидаемый результат
Разобран полный цикл сборки и редактирования временного XML-фрагмента.
На что обратить внимание
Фрагмент не копируется при вставке: его дети перемещаются. Для повторного использования заранее клонируйте нужные узлы.
Текст Книга здесь намеренно находится между детьми products как самостоятельный текст, а не является значением book.
Удаление DOM-узлов собственного фрагмента не выполняет удаление товаров из базы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.