25 882 документа
← К списку

СущностьDOM.ДобавитьДочерний (DOMEntity.AppendChild)

страница

СущностьDOM (DOMEntity)

ДобавитьДочерний (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.


     Методическая информация