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