Пропускает дочерние узлы текущего узла и позиционируется на следующий узел. Если текущий узел не содержит подчиненных узлов, то вызов метода аналогичен ЧтениеXML.Прочитать, в противном случае осуществляется пропуск всех дочерних узлов и осуществляется позиционирование на следующем узле.
Синтаксис
Пропустить()Полное описание, параметры и ограничения
ЧтениеXML.Пропустить (XMLReader.Skip)
ЧтениеXML (XMLReader)
Пропустить (Skip)
Доступен, начиная с версии 8.1.
Синтаксис:
Пропустить()
Описание:
Пропускает дочерние узлы текущего узла и позиционируется на следующий узел.
Если текущий узел не содержит подчиненных узлов, то вызов метода аналогичен ЧтениеXML.Прочитать, в противном случае осуществляется пропуск всех дочерних узлов и осуществляется позиционирование на следующем узле.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Прочитать товары из XML и пропустить ненужный раздел
Потоковый разбор извлекает только product. Раздел debug пропускается целиком, даже если внутри него тоже есть product.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Серверный контекст. Документ задан строкой; сеть и конфигурационные объекты не нужны.
XML без пространств имён; формат quantity — целое число. Для произвольных десятичных значений согласуйте формат отдельно.
ТекстXML = "<products>
|<product code=""A-01"" quantity=""3""/>
|<debug><product code=""НЕ-ТОВАР"" quantity=""999""/></debug>
|<product code=""B-02"" quantity=""1""/>
|</products>";
Товары = Новый Массив;
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(ТекстXML);
Попытка
Пока Чтение.Прочитать() Цикл
Если Чтение.ТипУзла <> ТипУзлаXML.НачалоЭлемента Тогда
Продолжить;
КонецЕсли;
Пока Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента
И Чтение.ЛокальноеИмя = "debug" Цикл
Чтение.Пропустить();
КонецЦикла;
Если Чтение.ТипУзла <> ТипУзлаXML.НачалоЭлемента
Или Чтение.ЛокальноеИмя <> "product" Тогда
Продолжить;
КонецЕсли;
Код = Чтение.ЗначениеАтрибута("code");
КоличествоТекст = Чтение.ЗначениеАтрибута("quantity");
Если Код = Неопределено Или КоличествоТекст = Неопределено Тогда
ВызватьИсключение "У товара отсутствует code или quantity";
КонецЕсли;
Сообщить(Чтение.КоличествоАтрибутов());
Для Номер = 0 По Чтение.КоличествоАтрибутов() - 1 Цикл
Сообщить(Чтение.ИмяАтрибута(Номер) + "=" + Чтение.ЗначениеАтрибута(Номер));
КонецЦикла;
Товары.Добавить(Новый Структура("Код,Количество", Код, Число(КоличествоТекст)));
КонецЦикла;
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Для Каждого Товар Из Товары Цикл
Сообщить(СтрШаблон("%1: %2", Товар.Код, Товар.Количество));
КонецЦикла;Разбор по шагам
Прочитать последовательно перемещается по узлам; атрибуты читаем только на начале product.
Пропустить на начале debug сразу переходит на следующий узел. Обрабатываем его в той же итерации, без дополнительного Прочитать, чтобы не потерять следующий товар.
Проверяем наличие обязательных атрибутов и отдельно показываем обход по индексам от нуля.
Преобразуем количество в число и добавляем понятную структуру в массив.
Как проверить результат
В результате 2 товара: A-01 с количеством 3 и B-02 с количеством 1; НЕ-ТОВАР отсутствует.
Удалите переводы строк между элементами: всё равно должны загрузиться оба товара.
Уберите quantity у A-01: должен возникнуть текст об отсутствующем атрибуте, а не успешная загрузка нуля.
Ожидаемый результат
Массив содержит только данные двух реальных товаров из учебного документа.
На что обратить внимание
Внешний XML проверяйте также по допустимым размерам, структуре и диапазонам количества.
Имена атрибутов чувствительны к регистру; code и Code — разные имена.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.