Метод ЗаменитьДочерний объекта ЭлементDOM

[1cwiki]

Раздел

Общие объекты

Подразделы

DOM

ИмяОбъекта

ЭлементDOM

ТипСтатьи

Методы

ЭлементDOM.ЗаменитьДочерний (DOMElement.ReplaceChild)
ЭлементDOM (DOMElement)
ЗаменитьДочерний (ReplaceChild)
Синтаксис:
ЗаменитьДочерний(<НовыйУзел>, <СтарыйУзел>)
Параметры:
<НовыйУзел> (обязательный)
Тип: ЭлементDOM.
Новый дочерний узел.
<СтарыйУзел> (обязательный)
Тип: ЭлементDOM.
Существующий дочерний узел.
Возвращаемое значение:
Тип: ЭлементDOM.
Значение прежнего узла.
Описание:
Заменяет дочерний узел, указанный параметром <СтарыйУзел>, на узел, указанный параметром <НовыйУзел>.
Если новый узел - это ФрагментДокумента, то заменяемый узел будет заменен всеми дочерними узлами фрагмента документа.
Если новый узел уже содержится в дереве документа, то он сначала удаляется из дочерних узлов старого родителя и вставляется в список дочерних узлов нового родителя.

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