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

[1cwiki]

Раздел

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

Подразделы

DOM

ИмяОбъекта

ДокументDOM

ТипСтатьи

Методы

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

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


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