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