ДокументHTML (HTMLDocument)

АдаптироватьУзел (AdoptNode)

Доступен, начиная с версии 8.2.

Синтаксис:

АдаптироватьУзел()

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

Тип: ДокументHTML, Неопределено.
Адаптированный узел или Неопределено, если адаптация не удалась.

Описание:

Выполняет адаптацию (заимствование) узла другого документа. Производит попытку заимствования узла из другого документа в данный.
Если адаптация поддерживается для узла, то производится замена документа-владельца у данного узла, всех его дочерних узлов и атрибутов рекурсивно.
Если узел имеет родительский узел, то вначале он удаляется из родительского узла.
Правила заимствования для типов узлов:

• Атрибут - документ-владелец устанавливается в Неопределено, свойство Указан устанавливается в Истина, заимствуются все потомки узла;
• ФрагментДокумента - все потомки фрагмента рекурсивно заимствуются;
• Документ - не может быть адаптирован;
• ОпределениеТипаДокумента - не может быть адаптирован;
• Элемент - атрибуты с установленным свойством Указан заимствуются, для нового узла-элемента создаются атрибуты, имеющие значения по умолчанию. Если в данном документе определена сущность с таким же именем, то формируется значение сущности для заимствованной ссылки;
• Текст, Комментарий - заимствуются

.

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

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

Примечание:

Причины вызова исключений:

• попытка адаптации узлов Документ, ОпределениеТипаДокумента;
• текущий документ адаптируемого узла в режиме Только для чтения.

Использование в версии:

Доступен, начиная с версии 8.2.

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