Метод АдаптироватьУзел объекта ДокументDOM

[1cwiki]

Раздел

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

Подразделы

DOM

ИмяОбъекта

ДокументDOM

ТипСтатьи

Методы

ДокументDOM.АдаптироватьУзел (DOMDocument.AdoptNode)
ДокументDOM (DOMDocument)
АдаптироватьУзел (AdoptNode)
Синтаксис:
АдаптироватьУзел()
Возвращаемое значение:
Тип: ДокументDOM; Неопределено.
Адаптированный узел или Неопределено, если адаптация не удалась.
Описание:
Выполняет адаптацию (заимствование) узла другого документа. Производит попытку заимствования узла из другого документа в данный.
Если адаптация поддерживается для узла, то производится замена документа-владельца у данного узла, всех его дочерних узлов и атрибутов рекурсивно.
Если узел имеет родительский узел, то вначале он удаляется из родительского узла.
Правила заимствования для типов узлов:
Атрибут - документ-владелец устанавливается в Неопределено, свойство Указан устанавливается в Истина, заимствуются все потомки узла;
ФрагментДокумента - все потомки фрагмента рекурсивно заимствуются;
Документ - не может быть адаптирован;
ОпределениеТипаДокумента - не может быть адаптирован;
Элемент - атрибуты с установленным свойством Указан заимствуются, для нового узла-элемента создаются атрибуты, имеющие значения по умолчанию. Все потомки рекурсивно заимствуются;
Сущность - не может быть адаптирован;
СсылкаНаСущность - заимствуется только данный узел. Если в данном документе определена сущность с таким же именем, то формируется значение сущности для заимствованной ссылки;
Нотация - не может быть адаптирован;
ИнструкцияОбработки, Текст, СекцияCDATA, Комментарий - заимствуются.

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