ЗаписьXml

Объект для потоковой записи XML. Непосредственно осуществляет запись в поток в процессе формирования XML, не храня записанные данные в памяти.

Сравнение ссылочное

Примеры

метод ЗаписатьТовар(Товар: Товар, Запись: ЗаписьXml)
    Запись.ЗаписатьНачалоЭлемента("product")
        .ЗаписатьАтрибут("code", Товар.Код)
        .ЗаписатьНачалоЭлемента("description")
            .ЗаписатьТекст(Товар.Наименование)
        .ЗаписатьКонецЭлемента()
        .ЗаписатьНачалоЭлемента("price")
            .ЗаписатьТекст(Товар.Цена)
        .ЗаписатьКонецЭлемента()
        .ЗаписатьНачалоЭлемента("count")
            .ЗаписатьТекст(Товар.Количество)
        .ЗаписатьКонецЭлемента()
    .ЗаписатьКонецЭлемента()
;

Конструкторы

ЗаписьXml

Конструктор записи XML в поток Поток с настройками Настройки в кодировке Кодировка.

Методы

ЗаписатьАтрибут

Записывает значение Значение атрибута Имя с пространствои имен ПространствоИмен. Атрибутов может быть произвольное количество. Атрибут может идентифицироваться полным именем или локальным именем и URI пространства имен. Атрибуты должны записываться непосредственно после записи начала элемента, иначе вызывается исключение. Возвращает текущий экземпляр.

ЗаписатьБезОбработки

Записывает XML-фрагмент текста Значение без обработки в результирующий текст. Например, можно приготовить фрагмент XML-документа и потом вставить его в целевой документ с помощью данного метода.

Следует быть очень осторожным с применением данного метода, так как размещаемый фрагмент не проверяется, что может сделать XML-документ синтаксически некорректным. Возвращает текущий экземпляр.

ЗаписатьИнструкциюОбработки

Записывает инструкцию обработки XML-файла. АдресИнструкции - Адрес инструкции. Данные - Данные. Возвращает текущий экземпляр.

ЗаписатьКомментарий

Записывает комментарий Комментарий. Возвращает текущий экземпляр.

ЗаписатьКонецДокумента

Закрывает все незакрытые теги.

ЗаписатьКонецЭлемента

Завершает запись элемента XML. Каждому вызову метода ЗаписатьНачалоЭлемента должен соответствовать вызов данного метода. Возвращает текущий экземпляр.

ЗаписатьНачалоДокумента

В начало документа помещается текст следующего вида: \<?Xml version="1.0" encoding="UTF-8"?\>. Данный метод должен быть вызван перед другими операциями записи Xml, иначе будет выброшено исключение. Возвращает текущий экземпляр.

ЗаписатьНачалоЭлемента

Записывает начало элемента Имя в пространстве имен ПространствоИмен. Возвращает текущий экземпляр.

ЗаписатьСекциюCData

Записывает данные Данные секции CDATA. Возвращает текущий экземпляр.

ЗаписатьСоответствиеПространстваИмен

Записывает соответствие префикса Префикс и URI пространства имен ПространствоИмен. Данный метод должен вызываться после обращения к методу ЗаписатьНачалоЭлемента. При передаче пустого префикса или префикса равного “xmlns” устанавливает соответствие префикса пространства по умолчанию (xmlns) и переданного URI. Возвращает текущий экземпляр.

ЗаписатьСсылкуНаСущность

Осуществляет запись ссылки на сущность ИмяСсылки. Возвращает текущий экземпляр.

ЗаписатьТекст

Записывает текст элемента. Перед вызовом данного метода должен быть вызван метод ЗаписатьНачалоЭлемента. Возвращает текущий экземпляр.

ЗаписатьТипДокумента

Записывает секцию DTD. Имя - Имя документа. ВнутреннееПодмножество - Внутреннее подмножество (собственно определение типа документа). SystemId - Системный идентификатор документа. PublicId - Публичный идентификатор документа. Возвращает текущий экземпляр.