XML.Delete

Delete (Удаление ветки и подчиненных веток)
Объект: Объект XML Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Исключения: Корневая или осиротевшая ветка. Визуальность: Нет

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

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

Синтаксис

XML.Delete(<Сохранить форматирование (INT)>=1)

Аргументы

• <Сохранить форматирование (INT)> - (необязательный аргумент) Аргумент включает режим сохранения текстового форматирования для удобства чтения текста XML документа человеком. В этом режиме каждая новая ветка следует с новой строки и каждый открывающийся тег ветки отделен от начала строки определенным количеством пробелов. Для разделителя используются два пробела на один уровень глубины ветки в структуре документа XML. Если режим не активен, функция не будет пытаться сохранить формирование при удалении (никаких дополнительных знаков, кроме смой ветки, удалено не будет).

Примеры

aObject:=XML.Create();

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

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

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

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

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

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

//Удаление ветки <subdata>
aNode.Delete();

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