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