Записывает текст элемента. Перед вызовом данного метода должен быть вызван метод ЗаписьXML.ЗаписатьНачалоЭлемента, так как иначе непонятно, к какому элементу относится текст. Для одного элемента данный метод может вызываться неоднократно. То есть текст элемента может записываться по частям.
Синтаксис
ЗаписатьТекст(<Текст>)Примеры платформы
Запись.ЗаписатьНачалоЭлемента("fruits");
Запись.ЗаписатьНачалоЭлемента("apple");
Запись.ЗаписатьТекст("Очень вкусно");
Запись.ЗаписатьКонецЭлемента();
Запись.ЗаписатьКонецЭлемента();Полное описание, параметры и ограничения
ЗаписьXML.ЗаписатьТекст (XMLWriter.WriteText)
ЗаписьXML (XMLWriter)
ЗаписатьТекст (WriteText)
Доступен, начиная с версии 8.1.
Синтаксис:
ЗаписатьТекст(<Текст>)
Параметры:
<Текст> (обязательный)
Тип: Строка.
Текст, помещаемый в элемент XML.
Описание:
Записывает текст элемента. Перед вызовом данного метода должен быть вызван метод ЗаписьXML.ЗаписатьНачалоЭлемента, так как иначе непонятно, к какому элементу относится текст. Для одного элемента данный метод может вызываться неоднократно. То есть текст элемента может записываться по частям.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Пример:
Запись.ЗаписатьНачалоЭлемента("fruits");
Запись.ЗаписатьНачалоЭлемента("apple");
Запись.ЗаписатьТекст("Очень вкусно");
Запись.ЗаписатьКонецЭлемента();
Запись.ЗаписатьКонецЭлемента();
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Создать XML товара без ручного экранирования
Название содержит амперсанд и знак меньше. ЗаписьXML правильно экранирует их, а ЧтениеXML восстанавливает исходный текст.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Выполняйте в серверной процедуре учебной обработки; файлы не создаются.
Оставьте специальные символы в названии: именно на них проверяется безопасная запись.
Запись = Новый ЗаписьXML;
Запись.УстановитьСтроку();
Попытка
Запись.ЗаписатьОбъявлениеXML();
Запись.ЗаписатьНачалоЭлемента("product");
Запись.ЗаписатьАтрибут("code", "A-01");
Запись.ЗаписатьНачалоАтрибута("quantity");
Запись.ЗаписатьТекст("3");
Запись.ЗаписатьКонецАтрибута();
Запись.ЗаписатьНачалоЭлемента("name");
Запись.ЗаписатьТекст("Книга & учебник <для новичка>");
Запись.ЗаписатьКонецЭлемента();
Запись.ЗаписатьКомментарий("Учебные данные");
Запись.ЗаписатьКонецЭлемента();
ТекстXML = Запись.Закрыть();
Исключение
Запись.Закрыть();
ВызватьИсключение;
КонецПопытки;
Сообщить(ТекстXML);
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(ТекстXML);
Попытка
Пока Чтение.Прочитать() Цикл
Если Чтение.ТипУзла = ТипУзлаXML.Текст Тогда
Сообщить(Чтение.Значение);
КонецЕсли;
КонецЦикла;
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();Разбор по шагам
УстановитьСтроку включает запись в память, ЗаписатьОбъявлениеXML добавляет объявление XML.
Все атрибуты записываем до содержимого элемента; поэтапная запись quantity заканчивается КонецАтрибута.
Для каждого НачалоЭлемента вызываем КонецЭлемента; Закрыть возвращает готовую строку.
Читаем строку обратно и выводим значение текстового узла.
Как проверить результат
В готовом XML амперсанд и знак меньше записаны как & и <.
Читатель выводит ровно Книга & учебник <для новичка>, без строк & или <.
Ожидаемый результат
XML содержит product с кодом A-01, количеством 3 и исходным названием.
На что обратить внимание
Не применяйте СтрЗаменить для экранирования перед ЗаписатьТекст: получится двойное экранирование.
ЗаписатьБезОбработки предназначен для уже корректной XML-разметки, а не для внешнего названия товара.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Настроить читаемый XML и проверить обратное чтение
UTF-8, версия 1.0, отступы элементов и атрибутов, два пробела. После записи снова читаем свой XML и сравниваем данные.
Где и как запускать
Полный серверный общий модуль собственной учебной базы; не тонкий клиент.
Подготовка
В своей учебной базе 8.5.1.1343 создайте серверный общий модуль УчебнаяЗаписьXML. Вставьте полный модуль одного урока и вызовите УчебнаяЗаписьXML.ВыполнитьПример() из собственной серверной команды.
Все тексты и товары заданы константами: Книга, A&B, количество 3. Учётные данные, файлы организации, HTTP и внешние XML не используются.
Первые шесть уроков работают только со строками/потоком в памяти. Последний создаёт один новый временный XML в собственной учебной базе; имя выводится, файл оставляется для ручной проверки.
Для урока файла имя конфигурации должно быть УчебнаяКонфигурацияСинтаксиса. Существующий файл не перезаписывается. После проверки удалите вручную только показанный собственный временный файл.
ПараметрыЗаписиXML неизменяемы после создания. Все пять параметров задаются конструктором, а не присваиванием свойств.
Процедура ВыполнитьПример() Экспорт
ПоУмолчанию = Новый ПараметрыЗаписиXML;
Параметры = Новый ПараметрыЗаписиXML("UTF-8", "1.0", Истина, Истина, " ");
Сообщить(Параметры.Версия = "1.0");
Сообщить(Параметры.Кодировка = "UTF-8");
Сообщить(Параметры.Отступ И Параметры.ОтступАтрибутов);
Сообщить(Параметры.СимволыОтступа = " ");
Сообщить(ПоУмолчанию.Версия = "1.0");
Запись = Новый ЗаписьXML;
Запись.УстановитьСтроку(Параметры);
Попытка
Сообщить(Запись.Параметры.Версия = "1.0");
Запись.ЗаписатьОбъявлениеXML();
Запись.ЗаписатьНачалоЭлемента("catalog");
Запись.ЗаписатьНачалоЭлемента("product");
Запись.ЗаписатьАтрибут("code", "A&B");
Запись.ЗаписатьАтрибут("quantity", "3");
Запись.ЗаписатьТекст("Книга <учебник> & пособие");
Запись.ЗаписатьКонецЭлемента();
Запись.ЗаписатьКонецЭлемента();
XML = Запись.Закрыть();
Исключение
Запись.Закрыть();
ВызватьИсключение;
КонецПопытки;
Товар = ПрочитатьУчебныйТовар(XML);
Сообщить(Товар.Код = "A&B");
Сообщить(Товар.Количество = "3");
Сообщить(Товар.Текст = "Книга <учебник> & пособие");
Сообщить(XML);
КонецПроцедуры
Функция ПрочитатьУчебныйТовар(XML)
Чтение = Новый ЧтениеXML;
Результат = Новый Структура("Корень,Код,Количество,Текст", "", "", "", "");
ВТоваре = Ложь;
Попытка
Чтение.УстановитьСтроку(XML);
Пока Чтение.Прочитать() Цикл
Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда
Если ПустаяСтрока(Результат.Корень) Тогда
Результат.Корень = Чтение.ЛокальноеИмя;
КонецЕсли;
Если Чтение.ЛокальноеИмя = "product" Тогда
ВТоваре = Истина;
Результат.Код = Чтение.ПолучитьАтрибут("code");
Результат.Количество = Чтение.ПолучитьАтрибут("quantity");
КонецЕсли;
ИначеЕсли ВТоваре И (Чтение.ТипУзла = ТипУзлаXML.Текст
ИЛИ Чтение.ТипУзла = ТипУзлаXML.СекцияCDATA) Тогда
Результат.Текст = Результат.Текст + Чтение.Значение;
ИначеЕсли Чтение.ТипУзла = ТипУзлаXML.КонецЭлемента
И Чтение.ЛокальноеИмя = "product" Тогда
ВТоваре = Ложь;
КонецЕсли;
КонецЦикла;
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Возврат Результат;
КонецФункцииРазбор по шагам
Создать параметры по умолчанию и отдельные параметры с пятью аргументами в правильном порядке. Свойства параметров только читаются.
Передать параметры в УстановитьСтроку и проверить фактические Запись.Параметры.
Объявление XML записать до корня. Атрибут A&B и текст с < и & передать штатным методам: их экранирование делает ЗаписьXML.
Закрыть возвращает строку. Полностью прочитать её и сравнить код, количество и текст, не полагаясь только на внешний вид.
Как проверить результат
Девять булевых проверок дают Истина.
XML выводится для чтения. Кодировка в объявлении строки — метка; настоящие UTF-8 байты показаны в уроке потока.
Ожидаемый результат
Готовая запись и обратное чтение собственного товара с понятными настройками оформления.
На что обратить внимание
Нельзя присвоить Параметры.Отступ: создайте новый объект параметров.
СимволыОтступа могут содержать только пробельные символы.
Не сравнивайте весь XML побайтно из-за отступов: данные проверяются читателем.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.