Считывает очередной атрибут элемента XML. После прочтения с помощью метода ЧтениеXML.Прочитать очередного узла, имеющего тип НачалоЭлемента, можно получить доступ к атрибутам данного элемента. Каждый вызов данного метода позволяет прочитать очередной атрибут. После прочтения очередного атрибута свойствам ЧтениеXML.ТипУзла, ЧтениеXML.Имя, ЧтениеXML.ЛокальноеИмя, ЧтениеXML.Префикс, ЧтениеXML.URIПространстваИмен и ЧтениеXML.Значение присваиваются значения в соответствии с прочитанным атрибутом.
Синтаксис
ПрочитатьАтрибут()Примеры платформы
Чтение.ОткрытьФайл("c:/docs/data.xml");
Пока Чтение.Прочитать() Цикл
Если Чтение.КоличествоАтрибутов() > 0 Тогда
Пока Чтение.ПрочитатьАтрибут() Цикл
КонецЦикла
КонецЕсли
КонецЦиклаПолное описание, параметры и ограничения
ЧтениеXML.ПрочитатьАтрибут (XMLReader.ReadAttribute)
ЧтениеXML (XMLReader)
ПрочитатьАтрибут (ReadAttribute)
Доступен, начиная с версии 8.1.
Синтаксис:
ПрочитатьАтрибут()
Возвращаемое значение:
Тип: Булево.
Истина - очередной атрибут прочитан; Ложь - атрибутов больше нет.
Описание:
Считывает очередной атрибут элемента XML. После прочтения с помощью метода ЧтениеXML.Прочитать очередного узла, имеющего тип НачалоЭлемента, можно получить доступ к атрибутам данного элемента. Каждый вызов данного метода позволяет прочитать очередной атрибут. После прочтения очередного атрибута свойствам ЧтениеXML.ТипУзла, ЧтениеXML.Имя, ЧтениеXML.ЛокальноеИмя, ЧтениеXML.Префикс, ЧтениеXML.URIПространстваИмен и ЧтениеXML.Значение присваиваются значения в соответствии с прочитанным атрибутом.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Пример:
Чтение.ОткрытьФайл("c:/docs/data.xml");
Пока Чтение.Прочитать() Цикл
Если Чтение.КоличествоАтрибутов() > 0 Тогда
Пока Чтение.ПрочитатьАтрибут() Цикл
// Обработка атрибута
КонецЦикла
КонецЕсли
КонецЦикла
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Различить явный code и подставленный DTD-атрибут kind
Собственный внутренний DTD требует code и задаёт kind=paper по умолчанию. Проверка DTD включена; на каждом атрибуте читается происхождение значения.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.
XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.
Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.
Проверки сообщениями ожидают Истина. XML-текст и объекты можно исследовать в отладчике; это не контракт Avito, SOAP или обмен типовой конфигурации.
XML = "<!DOCTYPE product [<!ELEMENT product (#PCDATA)><!ATTLIST product code CDATA #REQUIRED kind CDATA ""paper""><!ENTITY guide ""Книга""><!NOTATION png SYSTEM ""urn:guide:format:png""><!ENTITY picture SYSTEM ""urn:guide:picture"" NDATA png>]><product code=""A-01"">Книга</product>";
Параметры = Новый ПараметрыЧтенияXML("1.0", "", ПробельныеСимволыXML.ПоУмолчанию, ТипПроверкиXML.ОпределениеТипаДокумента, Истина, Ложь);
Чтение = Новый ЧтениеXML;
Попытка
Чтение.УстановитьСтроку(XML, Параметры);
Если Параметры.ТипПроверкиПравильности <> ТипПроверкиXML.ОпределениеТипаДокумента
Или Параметры.ИгнорироватьТипДокумента Тогда
ВызватьИсключение "Для этого урока нужна проверка собственного DTD";
КонецЕсли;
Если Не Чтение.ПерейтиКСодержимому() Или Чтение.ТипУзла <> ТипУзлаXML.НачалоЭлемента Тогда
ВызватьИсключение "Не найдено начало собственного корня";
КонецЕсли;
ЕстьЯвный = Ложь;
ЕстьПоУмолчанию = Ложь;
Пока Чтение.ПрочитатьАтрибут() Цикл
Если Чтение.Имя = "code" Тогда
ЕстьЯвный = Истина;
Сообщить(Чтение.Значение = "A-01" И Не Чтение.ЭтоАтрибутПоУмолчанию);
ИначеЕсли Чтение.Имя = "kind" Тогда
ЕстьПоУмолчанию = Истина;
Сообщить(Чтение.Значение = "paper" И Чтение.ЭтоАтрибутПоУмолчанию);
КонецЕсли;
КонецЦикла;
Сообщить(ЕстьЯвный И ЕстьПоУмолчанию);
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;Разбор по шагам
Включаем проверку DTD только для приведённой собственной строки без внешних источников.
ПерейтиКСодержимому пропускает DTD и доводит до product, не до его первого атрибута.
Явный code и подставленный kind проверяем по имени и ЭтоАтрибутПоУмолчанию.
Оба атрибута возвращают строки: происхождение и лексическое значение проверяются отдельно.
Как проверить результат
Три сравнения Истина.
Добавьте kind="paper" непосредственно в product: значение прежнее, происхождение default станет Ложь.
Удалите обязательный code: ожидается ошибка DTD-проверки, не успешное заполнение товара.
Ожидаемый результат
Показано отличие происхождения одинакового значения атрибута.
На что обратить внимание
Не обещайте DTD-проверку при ТипПроверкиXML.НетПроверки.
Подставленное значение схемы не доказывает, что поставщик прислал поле явно.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Прочитать все атрибуты и отличить пустую строку от отсутствия
ПрочитатьАтрибут используется непосредственно после начала элемента. У note значение пустое; атрибута missing нет.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.
XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.
Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.
Проверки сообщениями ожидают Истина. XML-текст и объекты можно исследовать в отладчике; это не контракт Avito, SOAP или обмен типовой конфигурации.
XML = "<product code=""A-01"" note=""""/>";
Параметры = Новый ПараметрыЧтенияXML;
Чтение = Новый ЧтениеXML;
Попытка
Чтение.УстановитьСтроку(XML, Параметры);
Если Не Чтение.ПерейтиКСодержимому() Или Чтение.ТипУзла <> ТипУзлаXML.НачалоЭлемента Тогда
ВызватьИсключение "Не найдено начало собственного корня";
КонецЕсли;
Атрибуты = Новый Соответствие;
Пока Чтение.ПрочитатьАтрибут() Цикл
Атрибуты.Вставить(Чтение.ЛокальноеИмя, Чтение.Значение);
КонецЦикла;
Сообщить(Атрибуты.Количество() = 2);
Сообщить(Атрибуты.Получить("note") = "");
Сообщить(Атрибуты.Получить("missing") = Неопределено);
Сообщить(Атрибуты.Получить("code") = "A-01");
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;Разбор по шагам
После ПерейтиКСодержимому остаёмся на product.
Каждый успешный ПрочитатьАтрибут передаёт очередное имя/значение через свойства чтения.
При False заканчиваем обход; отсутствующий ключ и пустое значение проверяем отдельно.
Как проверить результат
Четыре сравнения Истина.
Удалите note целиком: только проверка пустой строки изменится на Ложь.
Ожидаемый результат
Получен простой атрибутный контракт с различием missing/empty.
На что обратить внимание
ЛокальноеИмя недостаточно для раздельного хранения атрибутов из разных URI; здесь все атрибуты без пространства.
Не приводите Неопределено к пустой строке до проверки обязательности поля.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.