XML.AddAttribute

AddAttribute (Работа с атрибутами ветки)
Объект: Объект XML Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Исключения: Невозможно превратить в строку, атрибут уже присутствовал. Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Объект XML

Функция используется совместно с объектом ветки XML и добавляет новый атрибут в конец списка атрибутов текущей ветки. Для атрибута указывается его полное имя и значение.

Синтаксис

XML.AddAttribute(<Имя атрибута с пространством имен (STRING)>,<Значение атрибута (STRING)>)

Аргументы

• <Имя атрибута с пространством имен (STRING)> - Аргумент задает имя добавляемого атрибута с пространством имен, если оно необходимо.
• <Значение атрибута (STRING)> - Аргумент задает новое значение атрибута. Важно: перед использованием функции, перекодируйте устанавливаемое значение с помощью функции EncodeXMLString.

Примеры

aObject:=XML.Create();

//Добавление особой ветки
aObject.Text:="<?xml version=""1.0"" encoding=""UTF-8"" ?>";

//Позиционирование объекта ветки
aNode:=aObject.Root;

//Добавление обычной ветки
aNode:=aNode.AddNode("data",,"var1='value1' ns:var2=""some text"" var2=""same name with different ns is allowed""",0);

//Изменение значения текущей ветки (data)
//Значение может содержать подчиненные ветки
aNode.Value:="<subdata>text goes here...</subdata>";

//Будет выведено: "<?xml version="1.0" encoding="UTF-8" ?><data var1='value1' ns:var2="some text" var2="same name with different ns is allowed"><subdata>text goes here...</subdata></data>"
Message(aObject.Text);

//Изменение позиционирования
aNode.Path:="<data>";

//Добавляем новый атрибут
aNode.AddAttribute("var3","new value goes here");

//Будет выведено: "<?xml version="1.0" encoding="UTF-8" ?><data var1='value1' ns:var2="some text" var2="same name with different ns is allowed" var3="new value goes here"><subdata>text goes here...</subdata></data>"
Message(aObject.Text);