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