XML.GetAttributeName

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

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

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

Синтаксис

XML.GetAttributeName(<Индекс атрибута (INT)><Возвратить с пространством имен (INT)>=0):<Имя адресуемого атрибута (STRING)>

Аргументы

• <Индекс атрибута (INT)> - Задает индекс требуемого атрибута, индексирование начинается с единицы.
• <Возвратить с пространством имен (INT)> - (необязательный аргумент) По умолчанию (аргумент равен нулю), возвращается имя атрибута без пространства имен. Если аргумент равен единице, пространство имен будет сохранено.

Возвращаемое значение

Возвращает строковое значение

Примеры

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>";

Message("Атрибуты ветки "+aNode.Path+": ");
For i:=1 To aNode.AttributesCount() Do
  Message("  "+aNode.GetAttributeName(i,1)+": "+aNode.GetAttributeValue(i));
EndDo;
//Будут выведены атрибуты:
//  var1: value1
//  ns:var2: some text
//  var2: same name with different ns is allowed