ДокументDOM.ЗаменитьДочерний (DOMDocument.ReplaceChild)

ДокументDOM (DOMDocument)

ЗаменитьДочерний (ReplaceChild)

Синтаксис:

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

Параметры:

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

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

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

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

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

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

Описание:

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

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

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

Примечание:

Исключение генерируется в случаях:

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

Оглавление | Родительский раздел Платформа 8.3.13.1809