ЗаписьXml

Стд::Xml::ЗаписьXml
Базовые типы: Объект

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

graph BT;
ЗаписьXml-->Объект;

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

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

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

ЗаписьXml

ЗаписьXml(
  Поток: ПотокЗаписи,
  Настройки: НастройкиЗаписиXml,
  Кодировка: Кодировка|Строка = Кодировка.Utf8)

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

Методы

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

ИсключениеНедопустимоеСостояние - если текущий узел не является началом элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

ИсключениеНедопустимоеСостояние - если текущий узел не является началом элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

ИсключениеНедопустимоеСостояние - если текущий узел не является началом элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

ИсключениеНедопустимоеСостояние - если текущий узел не является началом элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

ИсключениеНедопустимоеСостояние - если текущий узел не является началом элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

ИсключениеНедопустимоеСостояние - если текущий узел не является началом элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

ИсключениеНедопустимоеСостояние - если текущий узел не является началом элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

ИсключениеНедопустимоеСостояние - если текущий узел не является началом элемента.

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

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

ИсключениеНедопустимоеСостояние - если текущий узел не является началом элемента.

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

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

ИсключениеНедопустимоеСостояние - если текущий узел не является началом элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

ИсключениеНедопустимоеСостояние - если текущий узел не является началом элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

ИсключениеНедопустимоеСостояние - если текущий узел не является началом элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

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

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи фрагмента текста.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

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

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

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

Исключения

ИсключениеЗаписи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 - при ошибке записи элемента.

ИсключениеНедопустимоеСостояние - если метод вызван после других операций записи XML.

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

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

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

Исключения

ИсключениеЗаписиXml - если соответствие пространства имен записано не при записи вышестоящего элемента или не при записи данного элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи секции.

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

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

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

Исключения

ИсключениеЗаписиXml - если текущий узел не является началом элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

ИсключениеНедопустимоеСостояние - если запись вызвана повторно или после начала записи тела XML.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

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

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

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

Исключения

ИсключениеЗаписиXml - при ошибке записи элемента.

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

Объект

ВСтроку, ПолучитьТип, Представление