Получает значение атрибута.
Синтаксис
ЗначениеАтрибута(<НомерАтрибута>)ЗначениеАтрибута(<ПолноеИмяАтрибута>)ЗначениеАтрибута(<ЛокальноеИмяАтрибута>, <URIПространстваИмен>)Примеры платформы
Чтение.ОткрытьФайл(ИмяФайла);
Попытка
ИдГруппы = Чтение.ЗначениеАтрибута("ИдГруппы");
Исключение
КонецПопытки;Полное описание, параметры и ограничения
ЧтениеXML.ЗначениеАтрибута (XMLReader.AttributeValue)
ЧтениеXML (XMLReader)
ЗначениеАтрибута (AttributeValue)
Доступен, начиная с версии 8.2.
Вариант синтаксиса: По номеру
Синтаксис:
ЗначениеАтрибута(<НомерАтрибута>)
Параметры:
<НомерАтрибута> (обязательный)
Тип: Число.
Порядковый номер атрибута, начиная с 0.
Вариант синтаксиса: По полному имени
Синтаксис:
ЗначениеАтрибута(<ПолноеИмяАтрибута>)
Параметры:
<ПолноеИмяАтрибута> (обязательный)
Тип: Строка.
Полное имя атрибута, включающее префикс.
Вариант синтаксиса: По локальному имени и пространству имен
Синтаксис:
ЗначениеАтрибута(<ЛокальноеИмяАтрибута>, <URIПространстваИмен>)
Параметры:
<ЛокальноеИмяАтрибута> (обязательный)
Тип: Строка.
Локальное имя атрибута, не включая префикс.
<URIПространстваИмен> (обязательный)
Тип: Строка.
URI пространства имен для локального имени атрибута.
Возвращаемое значение:
Тип: Строка, Неопределено.
Если атрибут найден, то метод возвращает строку, представляющую значение атрибута. Если атрибут в соответствии с заданными параметрами не найден, то метод возвращает значение Неопределено.
Описание:
Получает значение атрибута.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Пример:
Чтение.ОткрытьФайл(ИмяФайла);
Попытка
ИдГруппы = Чтение.ЗначениеАтрибута("ИдГруппы");
Исключение
КонецПопытки;
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Прочитать товары из 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 — разные имена.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.