Позиционирует текущее состояние объекта на первый атрибут текущего элемента. При этом свойствам ЧтениеXML.ТипУзла, ЧтениеXML.Имя, ЧтениеXML.ЛокальноеИмя, ЧтениеXML.Префикс, ЧтениеXML.URIПространстваИмен, ЧтениеXML.Значение и т.д. присваиваются значения, соответствующие прочитанным данным атрибута.
Синтаксис
ПервыйАтрибут()Полное описание, параметры и ограничения
ЧтениеXML.ПервыйАтрибут (XMLReader.FirstAttribute)
ЧтениеXML (XMLReader)
ПервыйАтрибут (FirstAttribute)
Доступен, начиная с версии 8.1.
Синтаксис:
ПервыйАтрибут()
Возвращаемое значение:
Тип: Булево.
Истина - атрибут прочитан, Ложь - в противном случае.
Описание:
Позиционирует текущее состояние объекта на первый атрибут текущего элемента.
При этом свойствам ЧтениеXML.ТипУзла, ЧтениеXML.Имя, ЧтениеXML.ЛокальноеИмя, ЧтениеXML.Префикс, ЧтениеXML.URIПространстваИмен, ЧтениеXML.Значение и т.д. присваиваются значения, соответствующие прочитанным данным атрибута.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Имеет смысл, если текущим узлом является НачалоЭлемента или Атрибут.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Обойти атрибуты курсором и затем перейти к дочернему элементу
ПервыйАтрибут/СледующийАтрибут изменяют текущий узел чтения. Собираем code/quantity по имени, не предполагая порядок атрибутов.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.
XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.
Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.
Проверки сообщениями ожидают Истина. XML-текст и объекты можно исследовать в отладчике; это не контракт Avito, SOAP или обмен типовой конфигурации.
XML = "<product code=""A-01"" quantity=""3""><title>Книга</title></product>";
Параметры = Новый ПараметрыЧтенияXML;
Чтение = Новый ЧтениеXML;
Попытка
Чтение.УстановитьСтроку(XML, Параметры);
Если Не Чтение.ПерейтиКСодержимому() Или Чтение.ТипУзла <> ТипУзлаXML.НачалоЭлемента Тогда
ВызватьИсключение "Не найдено начало собственного корня";
КонецЕсли;
Атрибуты = Новый Соответствие;
ЕстьАтрибут = Чтение.ПервыйАтрибут();
Пока ЕстьАтрибут Цикл
Сообщить(Чтение.ТипУзла = ТипУзлаXML.Атрибут);
Сообщить(Чтение.ИмеетИмя И Чтение.ИмеетЗначение);
Сообщить(Не Чтение.ЭтоАтрибутПоУмолчанию);
Атрибуты.Вставить(Чтение.Имя, Чтение.Значение);
ЕстьАтрибут = Чтение.СледующийАтрибут();
КонецЦикла;
Сообщить(Атрибуты.Количество() = 2);
Сообщить(Атрибуты.Получить("code") = "A-01");
Сообщить(Атрибуты.Получить("quantity") = "3");
Если Не Чтение.Прочитать() Тогда
ВызватьИсключение "Ожидался дочерний title";
КонецЕсли;
Сообщить(Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента И Чтение.Имя = "title");
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;Разбор по шагам
Создаём соответствие и начинаем позиционирование только на начале product.
После перехода свойства относятся к текущему атрибуту, не к product.
Значение quantity остаётся строкой "3": числовую конверсию для обмена делают отдельно.
После окончания атрибутов Прочитать продолжает чтение узлов документа; проверяем title.
Как проверить результат
Все десять сравнений Истина: по три на каждый явный атрибут, три для соответствия и одно для title.
Перестановка code/quantity в XML не изменяет итоговое соответствие.
Ожидаемый результат
Отработано позиционирование на атрибутах без зависимости от их порядка.
На что обратить внимание
ЭтоАтрибутПоУмолчанию имеет смысл именно на узле Атрибут.
Прочитать не заменяет СледующийАтрибут: это переход по узлам документа.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.