Получает значение атрибута.
Синтаксис
ЗначениеАтрибута(<НомерАтрибута>)ЗначениеАтрибута(<ПолноеИмяАтрибута>)ЗначениеАтрибута(<ЛокальноеИмяАтрибута>, <URIПространстваИмен>)Примеры платформы
Чтение.ОткрытьФайл(ИмяФайла);
Попытка
ИдГруппы = Чтение.ЗначениеАтрибута("ИдГруппы");
Исключение
КонецПопытки;Полное описание, параметры и ограничения
ЧтениеFastInfoset.ЗначениеАтрибута (FastInfosetReader.AttributeValue)
ЧтениеFastInfoset (FastInfosetReader)
ЗначениеАтрибута (AttributeValue)
Доступен, начиная с версии 8.2.
Вариант синтаксиса: По номеру
Синтаксис:
ЗначениеАтрибута(<НомерАтрибута>)
Параметры:
<НомерАтрибута> (обязательный)
Тип: Число.
Порядковый номер атрибута, начиная с 0.
Вариант синтаксиса: По полному имени
Синтаксис:
ЗначениеАтрибута(<ПолноеИмяАтрибута>)
Параметры:
<ПолноеИмяАтрибута> (обязательный)
Тип: Строка.
Полное имя атрибута, включающее префикс.
Вариант синтаксиса: По локальному имени и пространству имен
Синтаксис:
ЗначениеАтрибута(<ЛокальноеИмяАтрибута>, <URIПространстваИмен>)
Параметры:
<ЛокальноеИмяАтрибута> (обязательный)
Тип: Строка.
Локальное имя атрибута, не включая префикс.
<URIПространстваИмен> (обязательный)
Тип: Строка.
URI пространства имен для локального имени атрибута.
Возвращаемое значение:
Тип: Строка, Неопределено.
Если атрибут найден, то метод возвращает строку, представляющую значение атрибута. Если атрибут в соответствии с заданными параметрами не найден, то метод возвращает значение Неопределено.
Описание:
Получает значение атрибута.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Пример:
Чтение.ОткрытьФайл(ИмяФайла);
Попытка
ИдГруппы = Чтение.ЗначениеАтрибута("ИдГруппы");
Исключение
КонецПопытки;
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Найти атрибут единицы по URI, не по его порядковому номеру
Префиксы g и m принадлежат двум собственным пространствам имён. Все индексные методы вызываются только на НачалоЭлемента.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база на платформе 8.5.1.1343. Создайте серверный общий модуль УчебныеЗадачи и процедуру ВыполнитьПример() Экспорт; код урока без директив вставляйте в её тело. Каждый урок запускайте отдельно.
Все документы создаются из собственных строк и чисел в памяти. Не подставляйте файл XML, бинарный архив обмена, ссылки или данные рабочей базы вместо учебных значений.
Fast Infoset — двоичное представление XML. Для чтения нужен соответствующий reader, а не преобразование байтов в UTF-8-строку. Это не формат API Avito и не автоматическое сжатие произвольного JSON.
Запуск в 1С ещё не подтверждён; выполните контрольные проверки в учебной базе. Не сравнивайте точные байты двух кодировщиков: в заданиях проверяется восстановленная структура и значения.
Запись = Новый ЗаписьFastInfoset;
Запись.УстановитьДвоичныеДанные();
Попытка
Запись.ЗаписатьНачалоЭлемента("g:product");
Запись.ЗаписатьСоответствиеПространстваИмен("g", "urn:guide:product");
Запись.ЗаписатьСоответствиеПространстваИмен("m", "urn:guide:units");
Запись.ЗаписатьАтрибут("code", "A-01");
Запись.ЗаписатьАтрибут("unit", "urn:guide:units", "шт");
Сообщить(Запись.НайтиПрефикс("urn:guide:units") = "m");
Сообщить(Запись.КонтекстПространствИмен.НайтиURIПространстваИмен("g") = "urn:guide:product");
Запись.ЗаписатьТекст("Книга");
Запись.ЗаписатьКонецЭлемента();
Данные = Запись.Закрыть();
Исключение
Запись.Закрыть();
ВызватьИсключение;
КонецПопытки;
Если ТипЗнч(Данные) <> Тип("ДвоичныеДанные") Тогда
ВызватьИсключение "Не получены собственные Fast Infoset-данные";
КонецЕсли;
Сообщить(Данные.Размер() > 0);
Чтение = Новый ЧтениеFastInfoset;
Чтение.УстановитьДвоичныеДанные(Данные);
Попытка
НайденКорень = Ложь;
Пока Чтение.Прочитать() Цикл
Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда
НайденКорень = Истина;
Прервать;
КонецЕсли;
КонецЦикла;
Если Не НайденКорень Тогда
ВызватьИсключение "Не найден собственный корневой элемент";
КонецЕсли;
Сообщить(Чтение.ЛокальноеИмя = "product");
Сообщить(Чтение.Префикс = "g");
Сообщить(Чтение.URIПространстваИмен = "urn:guide:product");
Сообщить(Чтение.КонтекстПространствИмен.НайтиURIПространстваИмен("m") = "urn:guide:units");
Сообщить(Чтение.ПолучитьАтрибут("unit", "urn:guide:units") = "шт");
Сообщить(Чтение.ЗначениеАтрибута("code") = "A-01");
НайденаЕдиница = Ложь;
Для Индекс = 0 По Чтение.КоличествоАтрибутов() - 1 Цикл
Сообщить(СтрШаблон("Атрибут %1; тип %2", Чтение.ИмяАтрибута(Индекс), Чтение.ТипАтрибута(Индекс)));
Если Чтение.ЛокальноеИмяАтрибута(Индекс) = "unit"
И Чтение.URIПространстваИменАтрибута(Индекс) = "urn:guide:units" Тогда
НайденаЕдиница = Истина;
Сообщить(Чтение.ЗначениеАтрибута(Индекс) = "шт");
Сообщить("Префикс по индексу: " + Чтение.ПрефиксАтрибута(Строка(Индекс)));
КонецЕсли;
КонецЦикла;
Сообщить(НайденаЕдиница);
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Разбор по шагам
Записываем соответствия префиксов после начала элемента и до дочерних данных.
Идентичность элемента и атрибута определяем парой локальное имя/URI; g и m лишь выбранные сокращения.
Перебор индексов не меняет текущую позицию reader: все методы вызываются на НачалоЭлемента.
Не считаем xmlns и порядок атрибутов стабильным контрактом. У ПрефиксАтрибута локальная справка задаёт строковый индекс, поэтому здесь Строка(Индекс).
Как проверить результат
Проверки URI, префиксов, кода и единицы Истина; НайденаЕдиница Истина.
Если замените m на u во всех соответствиях источника, поиск unit по URI остаётся правильным; текст префикса изменится.
Ожидаемый результат
Разобраны пространства имён и безопасный индексный обход атрибутов.
На что обратить внимание
URI вида urn:guide:units — идентификатор, не URL для скачивания.
Справка ПрефиксАтрибута указывает Строка для индекса, в отличие от соседних методов; отдельно проверьте этот вызов в своём runtime.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.