ЭлементDOM.ЗаменитьДочерний (DOMElement.ReplaceChild)

Синтаксис:

ЗаменитьДочерний(<НовыйУзел>, <СтарыйУзел>)

Параметры:

<НовыйУзел> (обязательный)

Тип: ЭлементDOM.
Новый дочерний узел.

<СтарыйУзел> (обязательный)

Тип: ЭлементDOM.
Существующий дочерний узел.

Возвращаемое значение:

Тип: ЭлементDOM.
Значение прежнего узла.

Описание:

Заменяет дочерний узел, указанный параметром <СтарыйУзел>, на узел, указанный параметром <НовыйУзел>.
Если новый узел - это ФрагментДокумента, то заменяемый узел будет заменен всеми дочерними узлами фрагмента документа.
Если новый узел уже содержится в дереве документа, то он сначала удаляется из дочерних узлов старого родителя и вставляется в список дочерних узлов нового родителя.

Доступность:

Сервер, толстый клиент, внешнее соединение, мобильное приложение(сервер).

Примечание:

Исключение генерируется в случаях:
  • если данный узел не допускает в качестве дочерних добавляемый узел или добавляемый узел является одним из предков данного;
  • если узел добавляется сам в себя;
  • если данный узел - Документ и добавляется второй узел ОпределениеТипаДокумента или Элемент;
  • если добавляемый узел был создан документом отличным от создавшего данный узел;
  • если данный узел в режиме только для чтения или если предыдущий родитель добавляемого узла в режиме Только для чтения;
  • если заменяемый узел не найден;
  • если добавляемый узел является дочерним узлом узла Документ и реализация не поддерживает удаления узлов ОпределениеТипаДокумента и Элемент у узла Документ.

    

1C:Enterprise Developer's Community