Получает количество атрибутов у последнего прочитанного узла XML. Так как атрибуты могут быть только у элемента XML, доступ к ним может осуществляться только при прочтении узла, имеющего тип НачалоЭлемента.
Синтаксис
КоличествоАтрибутов()Примеры платформы
Чтение.ОткрытьФайл("c:/docs/data.xml");
Пока Чтение.Прочитать() Цикл
Если Чтение.КоличествоАтрибутов() > 0 Тогда
Пока Чтение.ПрочитатьАтрибут() Цикл
КонецЦикла
КонецЕсли
КонецЦиклаПолное описание, параметры и ограничения
ЧтениеXML.КоличествоАтрибутов (XMLReader.AttributeCount)
ЧтениеXML (XMLReader)
КоличествоАтрибутов (AttributeCount)
Доступен, начиная с версии 8.1.
Синтаксис:
КоличествоАтрибутов()
Возвращаемое значение:
Тип: Число.
Описание:
Получает количество атрибутов у последнего прочитанного узла XML. Так как атрибуты могут быть только у элемента XML, доступ к ним может осуществляться только при прочтении узла, имеющего тип НачалоЭлемента.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Пример:
Чтение.ОткрытьФайл("c:/docs/data.xml");
Пока Чтение.Прочитать() Цикл
Если Чтение.КоличествоАтрибутов() > 0 Тогда
Пока Чтение.ПрочитатьАтрибут() Цикл
// Обработка атрибута
КонецЦикла
КонецЕсли
КонецЦикла
Использование в версии:
Доступен, начиная с версии 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 — разные имена.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Прочитать атрибут тремя способами, не потеряв пространство имён
Один атрибут code сначала получаем по номеру, имени и паре локальное имя/URI. Во втором документе code и p:code — разные атрибуты.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.
XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.
Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.
Проверки сообщениями ожидают Истина. XML-текст и объекты можно исследовать в отладчике; это не контракт Avito, SOAP или обмен типовой конфигурации.
XML = "<product code=""A-01""/>";
Параметры = Новый ПараметрыЧтенияXML;
Чтение = Новый ЧтениеXML;
Попытка
Чтение.УстановитьСтроку(XML, Параметры);
Если Не Чтение.ПерейтиКСодержимому() Или Чтение.ТипУзла <> ТипУзлаXML.НачалоЭлемента Тогда
ВызватьИсключение "Не найдено начало собственного корня";
КонецЕсли;
Сообщить(Чтение.КоличествоАтрибутов() = 1);
Сообщить(Чтение.ПолучитьАтрибут(0) = "A-01");
Сообщить(Чтение.ПолучитьАтрибут("code") = "A-01");
Сообщить(Чтение.ПолучитьАтрибут("code", "") = "A-01");
Сообщить(Чтение.ПолучитьАтрибут("missing") = Неопределено);
Чтение.УстановитьСтроку("<product xmlns:p=""urn:guide:external"" code=""A-01"" p:code=""EXT-9""/>", Параметры);
Если Не Чтение.ПерейтиКСодержимому() Или Чтение.ТипУзла <> ТипУзлаXML.НачалоЭлемента Тогда
ВызватьИсключение "Не найдено начало собственного корня";
КонецЕсли;
Сообщить(Чтение.ПолучитьАтрибут("code", "") = "A-01");
Сообщить(Чтение.ПолучитьАтрибут("p:code") = "EXT-9");
Сообщить(Чтение.ПолучитьАтрибут("code", "urn:guide:external") = "EXT-9");
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;Разбор по шагам
Доводим чтение до начала элемента перед обращением к атрибутам.
Индекс 0 безопасен здесь потому, что первый документ содержит ровно один атрибут.
Неопределено у missing отличается от атрибута с явно заданной пустой строкой.
Во втором документе URI различает два code. Новый вызов УстановитьСтроку начинает чтение нового документа.
Как проверить результат
Восемь сравнений Истина; оба кода во втором документе сохраняются раздельно.
Замените префикс p на q в объявлении и атрибуте: поиск по URI останется корректен, по p:code — нет.
Ожидаемый результат
Сопоставлены три варианта метода и показан смысл квалифицированного имени.
На что обратить внимание
Для реального XML не выбирайте атрибут по индексу без контракта его позиции.
Префикс не является самим URI, а пространство имён по умолчанию элемента не переносится на обычный code.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.