ЗаписьXml

Иерархия типа

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

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

Примеры

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

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

ЗаписьXml

ЗаписьXml(
  Поток: ПотокЗаписи,
  Настройки: НастройкиЗаписиXml,
  Кодировка: Строка = "UTF-8")

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

Методы

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

ЗаписатьАтрибут(
  Имя: Строка,
  Значение: Строка,
  ПространствоИмен: Строка? = Неопределено
): ЗаписьXml

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

ЗаписатьАтрибутБайты

ЗаписатьАтрибутБайты(
  Имя: Строка,
  Значение: Байты,
  ПространствоИмен: Строка? = Неопределено
): ЗаписьXml

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

ЗаписатьАтрибутБайтыBase64

ЗаписатьАтрибутБайтыBase64(
  Имя: Строка,
  Значение: Байты,
  ПространствоИмен: Строка? = Неопределено
): ЗаписьXml

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

ЗаписатьАтрибутБулево

ЗаписатьАтрибутБулево(
  Имя: Строка,
  Значение: Булево,
  ПространствоИмен: Строка? = Неопределено
): ЗаписьXml

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

ЗаписатьАтрибутВремя

ЗаписатьАтрибутВремя(
  Имя: Строка,
  Значение: Время,
  ПространствоИмен: Строка? = Неопределено
): ЗаписьXml

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

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

ЗаписатьАтрибутДата(
  Имя: Строка,
  Значение: Дата,
  ПространствоИмен: Строка? = Неопределено
): ЗаписьXml

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

ЗаписатьАтрибутДатаВремя

ЗаписатьАтрибутДатаВремя(
  Имя: Строка,
  Значение: ДатаВремя,
  ПространствоИмен: Строка? = Неопределено
): ЗаписьXml

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

ЗаписатьАтрибутДлительность

ЗаписатьАтрибутДлительность(
  Имя: Строка,
  Значение: Длительность,
  ПространствоИмен: Строка? = Неопределено
): ЗаписьXml

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

ЗаписатьАтрибутМомент

ЗаписатьАтрибутМомент(
  Имя: Строка,
  Значение: Момент,
  ПространствоИмен: Строка
): ЗаписьXml

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

ЗаписатьАтрибутМомент

ЗаписатьАтрибутМомент(
  Имя: Строка,
  Значение: Момент,
  ЧасовойПояс: ЧасовойПояс? = Неопределено,
  ПространствоИмен: Строка? = Неопределено
): ЗаписьXml

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

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

ЗаписатьАтрибутУуид(
  Имя: Строка,
  Значение: Ууид,
  ПространствоИмен: Строка? = Неопределено
): ЗаписьXml

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

ЗаписатьАтрибутЧисло

ЗаписатьАтрибутЧисло(
  Имя: Строка,
  Значение: Число,
  ПространствоИмен: Строка? = Неопределено
): ЗаписьXml

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

ЗаписатьБайты

ЗаписатьБайты(Значение: Байты): ЗаписьXml

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

ЗаписатьБайтыBase64

ЗаписатьБайтыBase64(Значение: Байты): ЗаписьXml

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

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

ЗаписатьБезОбработки(Значение: Строка): ЗаписьXml

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

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

ЗаписатьБулево

ЗаписатьБулево(Значение: Булево): ЗаписьXml

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

ЗаписатьВремя

ЗаписатьВремя(Значение: Время): ЗаписьXml

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

ЗаписатьДатаВремя

ЗаписатьДатаВремя(Значение: ДатаВремя): ЗаписьXml

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

ЗаписатьДату

ЗаписатьДату(Значение: Дата): ЗаписьXml

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

ЗаписатьДлительность

ЗаписатьДлительность(Значение: Длительность): ЗаписьXml

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

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

ЗаписатьИнструкциюОбработки(
  АдресИнструкции: Строка,
  Данные: Строка
): ЗаписьXml

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

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

ЗаписатьКомментарий(Комментарий: Строка): ЗаписьXml

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

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

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

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

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

ЗаписатьКонецЭлемента(): ЗаписьXml

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

ЗаписатьМомент

ЗаписатьМомент(
  Значение: Момент,
  ЧасовойПояс: ЧасовойПояс? = Неопределено
): ЗаписьXml

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

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

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

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

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

ЗаписатьНачалоЭлемента(
  Имя: Строка,
  ПространствоИмен: Строка? = Неопределено
): ЗаписьXml

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

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

ЗаписатьСекциюCData(Данные: Строка): ЗаписьXml

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

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

ЗаписатьСоответствиеПространстваИмен(
  Префикс: Строка,
  ПространствоИмен: Строка
): ЗаписьXml

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

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

ЗаписатьСсылкуНаСущность(ИмяСсылки: Строка): ЗаписьXml

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

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

ЗаписатьТекст(Текст: Строка): ЗаписьXml

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

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

ЗаписатьТипДокумента(
  Имя: Строка,
  ВнутреннееПодмножество: Строка? = Неопределено,
  SystemId: Строка? = Неопределено,
  PublicId: Строка? = Неопределено
): ЗаписьXml

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

ЗаписатьУуид

ЗаписатьУуид(Значение: Ууид): ЗаписьXml

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

ЗаписатьЧисло

ЗаписатьЧисло(Значение: Число): ЗаписьXml

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

Список унаследованных методов

Объект