XML.Name

Name (Работа с именем ветки)
Объект: Объект XML Статус разработки: Реализована Тип: Атрибут Обращение к БД: Нет Доступность: Чтение и запись Визуальность: Нет

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

Атрибут используется совместно с объектом ветки XML и возвращает или изменяет наименование ветки в XML-документе. Наименования веток XML не могут содержать следующие знаки: !"#$%&'()*+,/;<=>?@[\]^`{|}~, а также знаки с кодами меньше или равными 32 (пробел). Кроме того имена не могут начинаться на цифру тире или точку. Разрешено иметь более одной ветки с одним именем для одной и той же родительской ветки. Измененное имя сохраняет предыдущее имя пространства имен, если оно присутствовало. Важно: изменение имен особенных тегов (см. Объект XML) будет вызывать исключение. Особые теги можно изменять только с помощью атрибута Text.

Синтаксис

XML.Name:<Имя текущей ветки XML без пространства имен (STRING)>

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

Возвращает строковое значение -- имя текущей ветки.

Примеры

aObject:=XML.create();
Стр:=aObject.LoadFromFile("c:\file.xml",65001);
If not IsEmpty(Стр) Then
  Message("Найдены ошибки при загрузке файла:"+_NEWLINE+Стр);
  Exit;
EndIf;

//Позиционирование объекта ветки
aNode:=aObject.Root;
aNode.Path:="<data><keyword><value>[5]";

//Будет выведено "value"
Message(aNode.Name);

//Изменение имени и пространства имен одновременно
aNode.FullName:="ns1:newvalue";

//Будет выведено "newvalue"
Message(aNode.Name);

//Изменение только имени
aNode.Name:="newvalue2";

//Будет выведено "ns1:newvalue2"
Message(aNode.FullName);

//Изменение только пространства имен
aNode.NameSpace:="ns2";

//Будет выведено "ns2:newvalue2"
Message(aNode.FullName);