Записывает атрибут элемента.
Синтаксис
ЗаписатьАтрибут(<ПолноеИмя>, <Значение>)ЗаписатьАтрибут(<ЛокальноеИмя>, <URIПространстваИмен>, <Значение>)Примеры платформы
Запись.ЗаписатьНачалоЭлемента("apple");
Запись.ЗаписатьСоответствиеПространстваИмен("nsp", "http://metrics.org");
Запись.ЗаписатьАтрибут("weight", "http://metrics.org", "12.5");
Запись.ЗаписатьКонецЭлемента();Полное описание, параметры и ограничения
ЗаписьУзловDOM.ЗаписатьАтрибут (DOMNodeWriter.WriteAttribute)
ЗаписьУзловDOM (DOMNodeWriter)
ЗаписатьАтрибут (WriteAttribute)
Доступен, начиная с версии 8.1.
Вариант синтаксиса: Запись атрибута с полным именем
Синтаксис:
ЗаписатьАтрибут(<ПолноеИмя>, <Значение>)
Параметры:
<ПолноеИмя> (обязательный)
Тип: Строка.
Полное имя атрибута. Может включать префикс.
<Значение> (обязательный)
Тип: Строка.
Значение атрибута.
Вариант синтаксиса: Запись атрибута с локальным именем и URI пространства имен
Синтаксис:
ЗаписатьАтрибут(<ЛокальноеИмя>, <URIПространстваИмен>, <Значение>)
Параметры:
<ЛокальноеИмя> (обязательный)
Тип: Строка.
Локальное имя атрибута.
<URIПространстваИмен> (обязательный)
Тип: Строка.
URI пространства имен для локального имени атрибута.
<Значение> (обязательный)
Тип: Строка.
Значение атрибута.
Описание:
Записывает атрибут элемента.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Атрибутов может быть произвольное количество. Атрибут может идентифицироваться полным именем или локальным именем и URI пространства имен. Атрибуты должны записываться после записи начала элемента и перед записью текста элемента.
Пример:
Запись.ЗаписатьНачалоЭлемента("apple");
Запись.ЗаписатьСоответствиеПространстваИмен("nsp", "http://metrics.org");
Запись.ЗаписатьАтрибут("weight", "http://metrics.org", "12.5");
Запись.ЗаписатьКонецЭлемента();
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Записать элемент и атрибут с разными пространствами имён
Имя g:product и URI пространства — разные сведения. Атрибут без префикса не получает пространство элемента; m:unit имеет собственный URI.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
В этом блоке каждый пример создаёт собственное дерево DOM в памяти. Файлы, сеть, данные документов и справочников не используются.
Открыть у ЧтениеУзловDOM принимает узел, а у ЗаписьУзловDOM — документ-владелец будущих узлов. Это не открытие файла.
URI = "urn:guide:products";
URIЕдиниц = "urn:guide:units";
Документ = Новый ДокументDOM("", "container");
Запись = Новый ЗаписьУзловDOM;
Запись.Открыть(Документ);
Попытка
Запись.ЗаписатьНачалоЭлемента("g:product");
Запись.ЗаписатьСоответствиеПространстваИмен("g", URI);
Запись.ЗаписатьСоответствиеПространстваИмен("m", URIЕдиниц);
Сообщить(Запись.НайтиПрефикс(URI) = "g");
Контекст = Запись.КонтекстПространствИмен;
Сообщить(Контекст.НайтиURIПространстваИмен("m") = URIЕдиниц);
Запись.ЗаписатьАтрибут("code", "A-01");
Запись.ЗаписатьАтрибут("unit", URIЕдиниц, "шт");
Запись.ЗаписатьНачалоЭлемента("name", URI);
Запись.ЗаписатьТекст("Книга");
Запись.ЗаписатьКонецЭлемента();
Запись.ЗаписатьКонецЭлемента();
Фрагмент = Запись.УзелDOM;
Исключение
Запись.Закрыть();
ВызватьИсключение;
КонецПопытки;
Запись.Закрыть();
Документ.ЭлементДокумента.ДобавитьДочерний(Фрагмент);
Товар = Документ.ЭлементДокумента.ПервыйДочерний;
Сообщить(Товар.ЛокальноеИмя = "product");
Сообщить(Товар.URIПространстваИмен = URI);
Сообщить(Товар.ПолучитьУзелАтрибута("code").URIПространстваИмен = "");
Сообщить(Товар.ПолучитьАтрибут(URIЕдиниц, "unit") = "шт");
Сообщить(Товар.ПервыйДочерний.URIПространстваИмен = URI);
Сообщить(Товар.ПервыйДочерний.ТекстовоеСодержимое = "Книга");Разбор по шагам
Начало g:product сопровождаем двумя объявлениями префиксов до записи атрибутов и содержимого.
НайтиПрефикс выполняется в активном контексте записи. КонтекстПространствИмен показывает сопоставление m с URI единиц.
code записан без URI, unit — с явным URI единиц. Вложенный name создаём вариантом метода с локальным именем и URI товара.
После присоединения фрагмента проверяем имена по паре ЛокальноеИмя/URI, а не только по написанию префикса.
Как проверить результат
Восемь логических сообщений дают Истина.
У product и name URI urn:guide:products; у code URI пустой, у unit — urn:guide:units.
Ожидаемый результат
Подготовлен namespace-aware XML и показана разница между пространствами элемента и атрибутов.
На что обратить внимание
Соответствие нужно записать до текста и вложенных элементов. Одной строки g:product недостаточно для переносимого namespace-aware документа.
URI пространства имён — идентификатор, а не адрес, по которому этот пример должен что-то скачивать.
Выбранный сериализатором префикс может отличаться; сравнивайте URI и локальное имя.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Создать XML-товар потоком команд и присоединить готовый фрагмент
ЗаписьУзловDOM создаёт узлы, принадлежащие указанному документу. Готовый фрагмент нужно отдельно включить в дерево; записанный текст не превращается в тег.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
В этом блоке каждый пример создаёт собственное дерево DOM в памяти. Файлы, сеть, данные документов и справочников не используются.
Открыть у ЧтениеУзловDOM принимает узел, а у ЗаписьУзловDOM — документ-владелец будущих узлов. Это не открытие файла.
Документ = Новый ДокументDOM("", "products");
Запись = Новый ЗаписьУзловDOM;
Запись.Открыть(Документ);
Попытка
Запись.ЗаписатьНачалоЭлемента("product");
Запись.ЗаписатьАтрибут("code", "A-01");
Запись.ЗаписатьНачалоАтрибута("label");
Запись.ЗаписатьТекст("Книга ");
Запись.ЗаписатьТекст("A&B");
Запись.ЗаписатьКонецАтрибута();
Запись.ЗаписатьТекст("Книга A&B ");
Запись.ЗаписатьСекциюCDATA("<описание>");
Запись.ЗаписатьКомментарий("Собственный учебный товар");
Запись.ЗаписатьИнструкциюОбработки("guide", "mode=test");
Запись.ЗаписатьКонецЭлемента();
Фрагмент = Запись.УзелDOM;
Исключение
Запись.Закрыть();
ВызватьИсключение;
КонецПопытки;
Запись.Закрыть();
Сообщить(Документ.ЭлементДокумента.ДочерниеУзлы.Количество() = 0);
Сообщить(Фрагмент.ДочерниеУзлы.Количество() = 1);
Документ.ЭлементДокумента.ДобавитьДочерний(Фрагмент);
Товар = Документ.ЭлементДокумента.ПервыйДочерний;
Сообщить(Товар.ИмяЭлемента = "product");
Сообщить(Товар.ПолучитьАтрибут("code") = "A-01");
Сообщить(Товар.ПолучитьАтрибут("label") = "Книга A&B");
Сообщить(Товар.ТекстовоеСодержимое = "Книга A&B <описание>");
Сообщить(Товар.ПолучитьЭлементыПоИмени("описание").Количество() = 0);
Сообщить(Фрагмент.ДочерниеУзлы.Количество() = 0);
Сериализатор = Новый ЗаписьDOM;
Вывод = Новый ЗаписьXML;
Вывод.УстановитьСтроку();
Попытка
Сериализатор.Записать(Документ, Вывод);
Исключение
Вывод.Закрыть();
ВызватьИсключение;
КонецПопытки;
Сообщить(Вывод.Закрыть());Разбор по шагам
Создаём документ с products и открываем запись. УзелDOM у записи — отдельный ФрагментДокументаDOM, а не весь документ.
Атрибут code записываем одной командой. Значение label записываем двумя порциями между НачалоАтрибута и КонецАтрибута; текст в этот момент относится к атрибуту.
После атрибутов создаём обычный текст, CDATA, комментарий и инструкцию. Начало/конец элемента должны быть сбалансированы.
Сохраняем ссылку на фрагмент до закрытия записи и добавляем его к products. Его дети перемещаются в целевой элемент; сам фрагмент не становится дополнительным XML-тегом.
ЗаписьDOM и ЗаписьXML показывают строковое представление. Амперсанд в обычном тексте/атрибуте экранирует сериализатор; CDATA остаётся символьными данными.
Как проверить результат
Все восемь логических проверок дают Истина.
В XML один product с code=A-01 и label=Книга A&B. Текст <описание> находится в CDATA, элемента описание нет.
После присоединения фрагмент пуст, а его product находится под products.
Ожидаемый результат
Создан полноценный учебный XML без ручной конкатенации тегов и без записи на диск.
На что обратить внимание
Не пишите атрибуты после текста или дочерних элементов: они должны идти сразу после начала элемента.
CDATA не очищает HTML и не шифрует данные. Последовательность ]]> и недопустимые XML-символы требуют отдельной обработки.
УзелDOM не является результатом типа Строка. Открыть записи не присоединяет результат к корню автоматически.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.