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