Difference between revisions of "XML.FullName"

From SunFlurry wiki
Jump to: navigation, search
1>Admin
(Created page with "{{infobox function |name=FullName |object=Объект XML |caption=Работа с именем ветки |type=0 |status=2 |db=0 |rw=3 |visual=0}} {{HeadLinks| * Main...")
 
m (1 revision imported)
 
(No difference)

Latest revision as of 09:06, 28 June 2021

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

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

Синтаксис

XML.FullName:<Имя текущей ветки 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);