XML.Value

From SunFlurry wiki
Jump to: navigation, search
  Value (Работа со значением ветки)
Объект:Объект XML
Статус разработки: Реализована
Тип:Атрибут
Обращение к БД:Нет
Доступность:Чтение и запись
Визуальность:Нет

Атрибут используется совместно с объектом ветки XML и возвращает или изменяет значение ветки (т.е. текст заключенный в объявления ветки: <Имя ветки>Значение ветки</Имя ветки>). Для веток, содержащих дочерние, возвращаемое значение также содержит дочерние объявления веток. При изменении значения допускается использование дочерних веток внутри устанавливаемого значения. Важно: изменение имен особенных тегов (см. Объект XML) будет вызывать исключение. Особые теги можно изменять только с помощью атрибута Text.

Синтаксис

XML.Value:<Значение текущей ветки XML (STRING)>

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

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

Примеры

aObject:=XML.Create();

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

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

//Добавление обычной ветки
aNode:=aNode.AddNode("data",,"var1='value1'",0);

//Будет выведено: "<?xml version="1.0" encoding="UTF-8" ?><data var1='value1'/>"
Message(aObject.Text);

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

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

//Будет выведено "text goes here..."
Message(aNode.Value);

//Будет выведено "<?xml version="1.0" encoding="UTF-8" ?><data var1='value1'><subdata>text goes here...</subdata></data>"
Message(aObject.Text);