ЗаписьXml
Стд::Xml::ЗаписьXml Базовые типы: Объект |
Иерархия типа
Объект для потоковой записи XML. Непосредственно осуществляет запись в поток в процессе формирования XML, не храня записанные данные в памяти. Запись типов данных осуществляется в соответствии со стандартом XML для каноничной записи.
Сравнение ссылочное
Примеры
метод ЗаписатьТовар(Товар: Товар, Запись: ЗаписьXml)
Запись.ЗаписатьНачалоЭлемента("product")
.ЗаписатьАтрибут("code", Товар.Код)
.ЗаписатьНачалоЭлемента("description")
.ЗаписатьТекст(Товар.Наименование)
.ЗаписатьКонецЭлемента()
.ЗаписатьНачалоЭлемента("price")
.ЗаписатьТекст(Товар.Цена)
.ЗаписатьКонецЭлемента()
.ЗаписатьНачалоЭлемента("count")
.ЗаписатьТекст(Товар.Количество)
.ЗаписатьКонецЭлемента()
.ЗаписатьКонецЭлемента()
;
Конструкторы
ЗаписьXml
ЗаписьXml(
Поток: ПотокЗаписи,
Настройки: НастройкиЗаписиXml,
Кодировка: Строка = "UTF-8")
Конструктор записи XML в поток Поток
с настройками Настройки
в кодировке Кодировка
.
Методы
ЗаписатьАтрибут
Записывает значение Значение
атрибута Имя
с пространством имен ПространствоИмен
. Атрибутов может быть произвольное количество. Атрибут может идентифицироваться полным именем или локальным именем и URI пространства имен. Атрибуты должны записываться непосредственно после записи начала элемента, иначе вызывается исключение. Возвращает текущий экземпляр.
ЗаписатьАтрибутБайты
Записывает значение типа Байты Значение
в шестнадцатеричной кодировке в атрибут Имя
с пространством имен ПространствоИмен
. Атрибут может идентифицироваться полным именем или локальным именем и URI пространства имен. Атрибуты должны записываться непосредственно после записи начала элемента, иначе вызывается исключение.
ЗаписатьАтрибутБайтыBase64
Записывает значение типа Байты Значение
как число в кодировке Base64 в атрибут Имя
с пространством имен ПространствоИмен
. Атрибут может идентифицироваться полным именем или локальным именем и URI пространства имен. Атрибуты должны записываться непосредственно после записи начала элемента, иначе вызывается исключение.
ЗаписатьАтрибутБулево
Записывает значение типа Булево Значение
в атрибут Имя
с пространством имен ПространствоИмен
. Атрибут может идентифицироваться полным именем или локальным именем и URI пространства имен. Атрибуты должны записываться непосредственно после записи начала элемента, иначе вызывается исключение.
ЗаписатьАтрибутВремя
Записывает значение типа Время Значение
в атрибут Имя
с пространством имен ПространствоИмен
. Атрибут может идентифицироваться полным именем или локальным именем и URI пространства имен. Атрибуты должны записываться непосредственно после записи начала элемента, иначе вызывается исключение.
ЗаписатьАтрибутДата
Записывает значение типа Дата Значение
в атрибут Имя
с пространством имен ПространствоИмен
. Атрибут может идентифицироваться полным именем или локальным именем и URI пространства имен. Атрибуты должны записываться непосредственно после записи начала элемента, иначе вызывается исключение.
ЗаписатьАтрибутДатаВремя
Перегрузка: ЗаписатьАтрибутДатаВремя(Имя: Строка, Значение: ДатаВремя, ЧасовойПояс: ЧасовойПояс? = Неопределено, ПространствоИмен: Строка? = Неопределено): ЗаписьXml |
Записывает значение типа ДатаВремя Значение
без часового пояса в атрибут Имя
с пространством имен ПространствоИмен
. Атрибут может идентифицироваться полным именем или локальным именем и URI пространства имен. Атрибуты должны записываться непосредственно после записи начала элемента, иначе вызывается исключение.
ЗаписатьАтрибутДатаВремя
ЗаписатьАтрибутДатаВремя(
Имя: Строка,
Значение: ДатаВремя,
ЧасовойПояс: ЧасовойПояс? = Неопределено,
ПространствоИмен: Строка? = Неопределено
): ЗаписьXml
Перегрузка: ЗаписатьАтрибутДатаВремя(Имя: Строка, Значение: ДатаВремя, ПространствоИмен: Строка): ЗаписьXml |
Записывает значение типа ДатаВремя Значение
в атрибут Имя
с пространством имен ПространствоИмен
. Если параметр ЧасовойПояс не указан, ДатаВремя записывается без часового пояса. Атрибут может идентифицироваться полным именем или локальным именем и URI пространства имен. Атрибуты должны записываться непосредственно после записи начала элемента, иначе вызывается исключение.
ЗаписатьАтрибутДлительность
ЗаписатьАтрибутДлительность(
Имя: Строка,
Значение: Длительность,
ПространствоИмен: Строка? = Неопределено
): ЗаписьXml
Записывает значение типа Длительность Значение
в атрибут Имя
с пространством имен ПространствоИмен
. Атрибут может идентифицироваться полным именем или локальным именем и URI пространства имен. Атрибуты должны записываться непосредственно после записи начала элемента, иначе вызывается исключение.
ЗаписатьАтрибутМомент
Записывает значение типа Момент Значение
в атрибут Имя
с пространством имен ПространствоИмен
. Атрибут может идентифицироваться полным именем или локальным именем и URI пространства имен. Атрибуты должны записываться непосредственно после записи начала элемента, иначе вызывается исключение.
ЗаписатьАтрибутУуид
Записывает значение типа Ууид Значение
в атрибут Имя
с пространством имен ПространствоИмен
. Атрибут может идентифицироваться полным именем или локальным именем и URI пространства имен. Атрибуты должны записываться непосредственно после записи начала элемента, иначе вызывается исключение.
ЗаписатьАтрибутЧисло
Записывает значение типа Число Значение
в атрибут Имя
с пространством имен ПространствоИмен
. Атрибут может идентифицироваться полным именем или локальным именем и URI пространства имен. Атрибуты должны записываться непосредственно после записи начала элемента, иначе вызывается исключение.
ЗаписатьБайты
Записывает текст элемента как Байты в шестнадцатеричной кодировке. Перед вызовом данного метода должен быть вызван метод ЗаписатьНачалоЭлемента. Возвращает текущий экземпляр.
ЗаписатьБайтыBase64
Записывает текст элемента как Байты в кодировке Base64. Перед вызовом данного метода должен быть вызван метод ЗаписатьНачалоЭлемента. Возвращает текущий экземпляр.
ЗаписатьБезОбработки
Записывает XML-фрагмент текста Значение
без обработки в результирующий текст. Например, можно приготовить фрагмент XML-документа и потом вставить его в целевой документ с помощью данного метода.
Следует быть очень осторожным с применением данного метода, так как размещаемый фрагмент не проверяется, что может сделать XML-документ синтаксически некорректным. Возвращает текущий экземпляр.
ЗаписатьБулево
Записывает текст элемента как тип Булево. Перед вызовом данного метода должен быть вызван метод ЗаписатьНачалоЭлемента. Возвращает текущий экземпляр.
ЗаписатьВремя
Записывает текст элемента как тип Время. Перед вызовом данного метода должен быть вызван метод ЗаписатьНачалоЭлемента. Возвращает текущий экземпляр.
ЗаписатьДатаВремя
ЗаписатьДатаВремя(
Значение: ДатаВремя,
ЧасовойПояс: ЧасовойПояс? = Неопределено
): ЗаписьXml
Записывает текст элемента как ДатаВремя. Если параметр ЧасовойПояс
не указан, ДатаВремя записывается без часового пояса. Перед вызовом данного метода должен быть вызван метод ЗаписатьНачалоЭлемента. Возвращает текущий экземпляр.
ЗаписатьДату
Записывает текст элемента как тип Дата. Перед вызовом данного метода должен быть вызван метод ЗаписатьНачалоЭлемента. Возвращает текущий экземпляр.
ЗаписатьДлительность
ЗаписатьДлительность(Значение: Длительность): ЗаписьXml
Записывает текст элемента как тип Длительность. Перед вызовом данного метода должен быть вызван метод ЗаписатьНачалоЭлемента. Возвращает текущий экземпляр.
ЗаписатьИнструкциюОбработки
Записывает инструкцию обработки XML-файла. АдресИнструкции
- Адрес инструкции. Данные
- Данные. Возвращает текущий экземпляр.
ЗаписатьКомментарий
Записывает комментарий Комментарий
. Возвращает текущий экземпляр.
ЗаписатьКонецДокумента
ЗаписатьКонецДокумента()
Закрывает все незакрытые теги.
ЗаписатьКонецЭлемента
ЗаписатьКонецЭлемента(): ЗаписьXml
Завершает запись элемента XML. Каждому вызову метода ЗаписатьНачалоЭлемента должен соответствовать вызов данного метода. Возвращает текущий экземпляр.
ЗаписатьМомент
Записывает текст элемента как тип Момент. Перед вызовом данного метода должен быть вызван метод ЗаписатьНачалоЭлемента. Возвращает текущий экземпляр.
ЗаписатьНачалоДокумента
ЗаписатьНачалоДокумента(): ЗаписьXml
В начало документа помещается текст следующего вида: <?Xml version="1.0" encoding="UTF-8"?>
. Данный метод должен быть вызван перед другими операциями записи Xml, иначе будет выброшено исключение. Возвращает текущий экземпляр.
ЗаписатьНачалоЭлемента
Записывает начало элемента Имя
в пространстве имен ПространствоИмен
. Возвращает текущий экземпляр.
ЗаписатьСекциюCData
Записывает данные Данные
секции CDATA. Возвращает текущий экземпляр.
ЗаписатьСоответствиеПространстваИмен
Записывает соответствие префикса Префикс
и URI пространства имен ПространствоИмен
. Данный метод должен вызываться после обращения к методу ЗаписатьНачалоЭлемента. При передаче пустого префикса или префикса равного “xmlns” устанавливает соответствие префикса пространства по умолчанию (xmlns) и переданного URI. Возвращает текущий экземпляр.
ЗаписатьСсылкуНаСущность
Осуществляет запись ссылки на сущность ИмяСсылки
. Возвращает текущий экземпляр.
ЗаписатьТекст
Записывает текст элемента. Перед вызовом данного метода должен быть вызван метод ЗаписатьНачалоЭлемента. Возвращает текущий экземпляр.
ЗаписатьТипДокумента
Записывает секцию DTD. Имя
- Имя документа. ВнутреннееПодмножество
- Внутреннее подмножество (собственно определение типа документа). SystemId
- Системный идентификатор документа. PublicId
- Публичный идентификатор документа. Возвращает текущий экземпляр.
ЗаписатьУуид
Записывает текст элемента как тип Ууид. Перед вызовом данного метода должен быть вызван метод ЗаписатьНачалоЭлемента. Возвращает текущий экземпляр.
ЗаписатьЧисло
Записывает текст элемента как тип Число. Перед вызовом данного метода должен быть вызван метод ЗаписатьНачалоЭлемента. Возвращает текущий экземпляр.