Тип: СписокУзловDOM. Список дочерних узлов DOM. В случае отсутствия дочерних узлов содержит пустой список.
Полное описание, параметры и ограничения
ДокументDOM.ДочерниеУзлы (DOMDocument.ChildNodes)
ДокументDOM (DOMDocument)
ДочерниеУзлы (ChildNodes)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: СписокУзловDOM.
Список дочерних узлов DOM. В случае отсутствия дочерних узлов содержит пустой список.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Создать документ с собственным описанием типа без внешнего DTD
Полный конструктор ДокументDOM принимает ОпределениеТипаДокументаDOM. Пустое описание с именем products не является схемой проверки товаров и ничего не скачивает.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
Описание типа создаётся только из собственного имени и двух пустых идентификаторов. Внешний DTD/URL/файл и внутренние объявления не задаются.
ОписаниеТипа = Новый ОпределениеТипаДокументаDOM("products", "", "");
Документ = Новый ДокументDOM("", "products", ОписаниеТипа);
Сообщить(Документ.ОпределениеТипаДокумента.Имя = "products");
Сообщить(ОписаниеТипа.ПубличныйИдентификатор = "");
Сообщить(ОписаниеТипа.СистемныйИдентификатор = "");
Сообщить(ОписаниеТипа.ВнутреннееПодмножество = "");
Сообщить(ОписаниеТипа.Сущности.Количество() = 0);
Сообщить(ОписаниеТипа.Нотации.Количество() = 0);
Сообщить(Документ.ДочерниеУзлы.Количество() = 2);
Сообщить(Документ.ЭлементДокумента.ИмяЭлемента = "products");
Товар = Документ.СоздатьЭлемент("product");
Товар.УстановитьАтрибут("code", "A-01");
Документ.ЭлементДокумента.ДобавитьДочерний(Товар);
Сообщить(Документ.ЭлементДокумента.ДочерниеУзлы.Количество() = 1);
Сообщить(ОписаниеТипа.Сущности.Количество() = 0);Разбор по шагам
Создаём ОпределениеТипаДокументаDOM с именем products и пустыми PUBLIC/SYSTEM. В отличие от чтения внешнего DTD это только собственный объект в памяти.
Полный конструктор документа принимает описание третьим аргументом. Два дочерних узла документа — описание типа и корень products.
Коллекции Сущности и Нотации пустые: никаких объявлений в подготовке не было.
Добавляем product без обязательного описания полей. Отсутствие исключения не доказывает валидность товара по DTD: здесь нет определений и проверок схемы.
Как проверить результат
Все десять логических сообщений дают Истина.
У документа есть описание типа products и корень products; в корне один учебный товар A-01.
Добавление товара не заполняет Сущности/Нотации и не загружает внешнюю схему.
Ожидаемый результат
Разобраны полный конструктор документа и отличие объекта DOCTYPE от фактической валидации XML.
На что обратить внимание
ОпределениеТипаДокументаDOM не заменяет НаборСхемXML и не создаёт XSD автоматически.
Не подставляйте недоверенные системные/публичные идентификаторы и не превращайте этот пример в загрузку внешних DTD.
Сущности и нотации — объявления типа документа, не товарные строки и не XML-элементы product.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Заменить корень собственного XML, сохранив удалённый узел
У документа может быть только один корневой элемент. Новый корень создаём тем же документом и заменяем старый, а не добавляем второй корень рядом.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
Преобразования выполняются только над собственным XML в памяти. Примеры не читают файлы, внешние DTD, URL или данные информационной базы.
У методов DOM возвращаемый узел сохраняйте в переменную: исходная ссылка и результат операции не всегда обозначают один объект.
Документ = Новый ДокументDOM("", "draft");
СтарыйКорень = Документ.ЭлементДокумента;
СтарыйКорень.ДобавитьДочерний(Документ.СоздатьТекстовыйУзел("Черновик"));
НовыйКорень = Документ.СоздатьЭлемент("products");
НовыйКорень.ДобавитьДочерний(Документ.СоздатьТекстовыйУзел("Книга"));
Возвращённый = Документ.ЗаменитьДочерний(НовыйКорень, СтарыйКорень);
Сообщить(Возвращённый.УзелИдентичен(СтарыйКорень));
Сообщить(СтарыйКорень.РодительскийУзел = Неопределено);
Сообщить(СтарыйКорень.ТекстовоеСодержимое = "Черновик");
Сообщить(Документ.ЭлементДокумента.УзелИдентичен(НовыйКорень));
Сообщить(Документ.ЭлементДокумента.ТекстовоеСодержимое = "Книга");
Отсоединённый = Документ.УдалитьДочерний(НовыйКорень);
Сообщить(Отсоединённый.УзелИдентичен(НовыйКорень));
Сообщить(Документ.ЭлементДокумента = Неопределено);
Документ.ДобавитьДочерний(Отсоединённый);
Сообщить(Документ.ЭлементДокумента.ИмяЭлемента = "products");
Сообщить(Документ.ДочерниеУзлы.Количество() = 1);Разбор по шагам
Создаём draft и новый products одним документом-владельцем. Новый products пока отсоединён от дерева.
ЗаменитьДочерний возвращает старый корень. Он больше не имеет родителя, но его текст Черновик остаётся доступным через сохранённую ссылку.
УдалитьДочерний отсоединяет новый корень: временно ЭлементДокумента становится Неопределено. Такой промежуточный документ не отправляем получателю.
ДобавитьДочерний присоединяет сохранённый products обратно. В конце снова один корень и текст Книга.
Как проверить результат
Все девять логических сообщений дают Истина.
Старый draft не исчезает из памяти, пока сохранена ссылка; у завершённого документа корень products.
После обратного присоединения список дочерних узлов документа содержит один элемент.
Ожидаемый результат
Разобраны замена, отсоединение и повторное присоединение корня собственного дерева.
На что обратить внимание
Не добавляйте второй элемент к ДокументDOM, пока первый корень существует: ограничение одного корня сохраняется.
Не вставляйте узел другого документа напрямую; создавайте узел нужным документом или используйте импорт.
УдалитьДочерний меняет DOM в памяти, не удаляет запись из информационной базы и не удаляет файл.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.