Получает префикс атрибута с указанным индексом. Так как атрибуты могут быть только у элемента XML, доступ к ним может осуществляться только при прочтении узла, имеющего тип НачалоЭлемента.
Синтаксис
ПрефиксАтрибута(<Индекс>)Полное описание, параметры и ограничения
ЧтениеFastInfoset.ПрефиксАтрибута (FastInfosetReader.AttributePrefix)
ЧтениеFastInfoset (FastInfosetReader)
ПрефиксАтрибута (AttributePrefix)
Доступен, начиная с версии 8.1.
Синтаксис:
ПрефиксАтрибута(<Индекс>)
Параметры:
<Индекс> (обязательный)
Тип: Строка.
Индекс атрибута.
Возвращаемое значение:
Тип: Строка.
Описание:
Получает префикс атрибута с указанным индексом. Так как атрибуты могут быть только у элемента XML, доступ к ним может осуществляться только при прочтении узла, имеющего тип НачалоЭлемента.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Найти атрибут единицы по 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.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.