ДокументHTML.ИмпортироватьУзел (HTMLDocument.ImportNode)
ДокументHTML (HTMLDocument)
ИмпортироватьУзел (ImportNode)
Доступен, начиная с версии 8.2.
Синтаксис:
ИмпортироватьУзел(<Узел>, <Рекурсивно>)Параметры:
<Узел> (обязательный)
Импортируемый узел HTMLDOM.
<Рекурсивно> (обязательный)
Признак "глубокого" импортирования.
Истина - будут рекурсивно импортированы все дочерние узлы импортируемого узла. Исключения составляют узлы Атрибут и СсылкаНаСущность.
Для Атрибут дочерние узлы импортируются всегда.
Ложь - импортируется только переданный узел.
Возвращаемое значение:
Тип: АтрибутHTML, ЭлементHTML, ЭлементКнопкаHTML, ЭлементВводаHTML, ЭлементЗаголовокHTML, ЭлементРазметкаHTML, ЭлементПлавающийФреймHTML, ЭлементВставкаHTML, ЭлементФреймHTML, ЭлементНаборФреймовHTML, ЭлементМетаHTML, ЭлементОбъектHTML, ЭлементСкриптHTML, ЭлементТаблицаHTML, ЭлементСтрокаТаблицыHTML, ЭлементЯчейкаТаблицыHTML, ЭлементКолонкаТаблицыHTML, ЭлементЗаголовокТаблицыHTML, ЭлементБлокHTML, ЭлементЛинияHTML, ЭлементФорматированногоТекстаHTML, ЭлементКартинкаHTML, ЭлементСвязьHTML, ЭлементЯкорьHTML, ЭлементАплетHTML, ЭлементФормаHTML, ДокументHTML, ТекстHTML, КомментарийHTML.Описание:
Импортирует узел из другого документа DOM в данный.
Для каждого узла импортируются ТипУзла, ИмяУзла, а также свойства, относящиеся к пространствам имен: ЛокальноеИмя, Префикс. Пользовательские данные не переносятся.
Правила импорта для типов узлов:
- Атрибут - ЭлементВладелец устанавливается в Неопределено, признак Указан устанавливается в Истина, импортируются все потомки узла;
- Документ - не может быть импортирован;
- ОпределениеТипаДокумента - не может быть импортирован;
- Элемент - атрибуты с установленным свойством Указан импортируются, для нового узла-элемента создаются атрибуты, имеющие значения по умолчанию;
- Сущность - узлы могут быть импортированы, даже если документ находится в режиме Только для чтения. Свойства ПубличныйИдентификатор, СистемныйИдентификатор и ИмяНотации копируются;
- СсылкаНаСущность - импортируется только данный узел. Если в данном документе определена сущность с таким же именем, то формируется значение сущности для импортированной ссылки;
- Нотация - узлы могут быть импортированы, даже если документ находится в режиме только для чтения. Свойства ПубличныйИдентификатор, СистемныйИдентификатор копируются;
- ИнструкцияОбработки - копируются свойства Цель и Данные;
- Текст, Комментарий - копируются свойства ТекстHTML.Данные, КомментарийHTML.Данные и ТекстHTML.Размер, КомментарийHTML.Размер.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Причины вызова исключений:- импортируемые имена содержат символы, недопустимые стандартом XML данного документа.
Использование в версии:
Доступен, начиная с версии 8.2.