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

[1cwiki]

Раздел

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

Подразделы

HTML

ИмяОбъекта

ДокументHTML

ТипСтатьи

Методы

ДокументHTML.ИмпортироватьУзел (HTMLDocument.ImportNode)
ДокументHTML (HTMLDocument)
ИмпортироватьУзел (ImportNode)
Синтаксис:
ИмпортироватьУзел(<Узел>, <Рекурсивно>)
Параметры:
<Узел> (обязательный)
Тип: ДокументHTML.
Импортируемый узел HTMLDOM.
<Рекурсивно> (обязательный)
Тип: Булево.
Признак "глубокого" импортирования.
Истина - будут рекурсивно импортированы все дочерние узлы импортируемого узла. Исключения составляют узлы Атрибут и СсылкаНаСущность.
Для Атрибут дочерние узлы импортируются всегда.
Ложь - импортируется только переданный узел.
Возвращаемое значение:
Тип: ДокументHTML.

Описание:
Импортирует узел из другого документа DOM в данный.
Для каждого узла импортируются ТипУзла, ИмяУзла, а также свойства, относящиеся к пространствам имен: ЛокальноеИмя, Префикс. Пользовательские данные не переносятся.
Правила импорта для типов узлов:
Атрибут - ЭлементВладелец устанавливается в Неопределено, признак Указан устанавливается в Истина, импортируются все потомки узла;

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


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