ТипУзлаXML.НачалоЭлемента

Свойства · StartElement

Соответствует узлу XML.

Полное описание, параметры и ограничения

ТипУзлаXML.НачалоЭлемента (XMLNodeType.StartElement)

ТипУзлаXML (XMLNodeType)

НачалоЭлемента (StartElement)

Доступен, начиная с версии 8.0.

Описание:
Соответствует узлу XML.
Использование в версии:

Доступен, начиная с версии 8.0.

Методическая информация

Практические примеры

Прочитать число, когда XML не содержит распознаваемого типа

В собственном XML есть текст 750, но нет xsi:type, а имя total не встроенный тип. Отличаем отсутствие определения типа от невозможности явно прочитать известный формат.

Где и как запускать

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.

  2. XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.

  3. Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.

  4. Проверки сообщениями ожидают Истина. XML-текст и объекты можно исследовать в отладчике; это не контракт Avito, SOAP или обмен типовой конфигурации.

XML = "<total xmlns=""urn:guide:totals"">750</total>";
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XML);
НайденЭлемент = Ложь;
Пока Чтение.Прочитать() Цикл
    Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда
        НайденЭлемент = Истина;
        Прервать;
    КонецЕсли;
КонецЦикла;
Если Не НайденЭлемент Тогда
    Чтение.Закрыть();
    ВызватьИсключение "В собственном XML не найден корневой элемент";
КонецЕсли;
Попытка
    Сообщить(ПолучитьXMLТип(Чтение) = Неопределено);
    Сообщить(Не ВозможностьЧтенияXML(Чтение));
    Сумма = ПрочитатьXML(Чтение, Тип("Число"));
    Чтение.Закрыть();
Исключение
    Чтение.Закрыть();
    ВызватьИсключение;
КонецПопытки;
Сообщить(ТипЗнч(Сумма) = Тип("Число"));
Сообщить(Сумма = 750);

Разбор по шагам

  1. ПолучитьXMLТип не находит явного типа или встроенного имени элемента. Возвращается Неопределено.

  2. ВозможностьЧтенияXML также опирается на определение XML-типа, поэтому автоматическое распознавание даёт Ложь.

  3. Для полностью известного собственного формата передаём ожидаемый тип Число в ПрочитатьXML. Текст 750 соответствует его XML-лексике.

  4. При несоответствии текста ожидаемому типу будет исключение. Не проглатываем его и не заменяем произвольно нулём.

Как проверить результат

  1. Четыре проверки дают Истина.

  2. Замените только 750 на нечисловой текст: ожидайте исключение чтения и диагностику, а не успешную сумму 0.

Ожидаемый результат

Явное чтение собственного числового формата с отличием от автоматического распознавания.

На что обратить внимание

  1. Задавать Число для любого неизвестного XML нельзя: нужен известный контракт содержимого.

  2. Неопределено у XML-типа — не число 0, не пустая сумма и не успешная валидация.

  3. Не передавайте произвольные типы объектов базы ради пробного чтения.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.