Устанавливает атрибут в элемент. Если значение локального имени и URI пространства имен совпадают с одним из существующих атрибутов, то данный атрибут заменяется на новый.
Синтаксис
УстановитьУзелАтрибута(<НовыйАтрибут>)Полное описание, параметры и ограничения
ЭлементDOM.УстановитьУзелАтрибута (DOMElement.SetAttributeNode)
ЭлементDOM (DOMElement)
УстановитьУзелАтрибута (SetAttributeNode)
Доступен, начиная с версии 8.1.
Синтаксис:
УстановитьУзелАтрибута(<НовыйАтрибут>)
Параметры:
<НовыйАтрибут> (обязательный)
Тип: АтрибутDOM.
Устанавливаемый атрибут DOM.
Возвращаемое значение:
Тип: АтрибутDOM, Неопределено.
Возвращает атрибут, который был замещен новым атрибутом или Неопределено, если такого нет.
Описание:
Устанавливает атрибут в элемент.
Если значение локального имени и URI пространства имен совпадают с одним из существующих атрибутов, то данный атрибут заменяется на новый.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Причины вызова исключений:
узел-атрибут был создан другим документом;
данный узел в режиме Только для чтения;
устанавливаемый атрибут является уже узлом-атрибутом другого узла Элемент, необходимо явное клонирование атрибута.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Назначить товару XML-идентификатор и работать с узлом атрибута
Атрибут id становится идентификатором только после явной отметки. Остальные атрибуты читаем и удаляем через элемент и коллекцию.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Серверный контекст. Все узлы принадлежат одному документу.
Идентификатор A-01 уникален в пределах учебного документа.
Документ = Новый ДокументDOM("", "products");
Товар = Документ.СоздатьЭлемент("product");
Документ.ЭлементДокумента.ДобавитьДочерний(Товар);
Атрибут = Документ.СоздатьАтрибут("id");
Атрибут.Значение = "A-01";
Товар.УстановитьУзелАтрибута(Атрибут);
Товар.УстановитьАтрибутИдентификатор("id", Истина);
Сообщить(Атрибут.Имя);
Сообщить(Атрибут.Значение);
Сообщить(Атрибут.ЯвляетсяИдентификатором);
Сообщить(Атрибут.Указан);
Сообщить(Атрибут.ЭлементВладелец = Товар);
Сообщить(Документ.ПолучитьЭлементПоИдентификатору("A-01").УзелИдентичен(Товар));
Сообщить(Товар.ЕстьАтрибут("id"));
Сообщить(Товар.ПолучитьАтрибут("id"));
Сообщить(Товар.ПолучитьУзелАтрибута("id").УзелИдентичен(Атрибут));
Товар.УстановитьАтрибут("quantity", "3");
Атрибуты = Товар.Атрибуты;
Сообщить(Атрибуты.Количество());
Для Номер = 0 По Атрибуты.Количество() - 1 Цикл
Текущий = Атрибуты.Элемент(Номер);
Сообщить(Текущий.Имя + "=" + Текущий.Значение);
КонецЦикла;
Сообщить(Атрибуты.ПолучитьИменованныйЭлемент("quantity").Значение);
Товар.УдалитьАтрибут("quantity");
Временный = Документ.СоздатьАтрибут("temporary");
Временный.Значение = "yes";
Атрибуты.УстановитьИменованныйЭлемент(Временный);
Атрибуты.УдалитьИменованныйЭлемент("temporary");
Сообщить(Атрибуты.Количество());Разбор по шагам
Создаём атрибут фабрикой документа, задаём значение и присоединяем к товару.
УстановитьАтрибутИдентификатор отмечает id; после этого документ может найти товар по его значению.
ПолучитьАтрибут возвращает строку, ПолучитьУзелАтрибута — объект атрибута.
Обходим коллекцию без предположения о порядке; удаляем quantity и временный атрибут.
Как проверить результат
Найденный по A-01 элемент идентичен товару; атрибут принадлежит товару и имеет признак идентификатора.
Перед удалением есть 2 атрибута, после всей последовательности остаётся только id: количество 1.
Ожидаемый результат
Товар имеет настоящий DOM-идентификатор, работа с атрибутом и его строковым значением различена.
На что обратить внимание
Имя id само по себе не гарантирует статус идентификатора: нужна отметка или соответствующее объявление схемы.
Порядок атрибутов XML незначим; не полагайтесь на то, что id имеет индекс 0.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.