Difference between revisions of "XML.ByName"
1>Admin (Created page with "{{infobox function |name=ByName |object=Объект XML |caption=Получение подчиненной ветки по имени |type=1 |status=2 |db=0 |exception=...") |
m (1 revision imported) |
(No difference)
|
Latest revision as of 08:06, 28 June 2021
ByName (Получение подчиненной ветки по имени) | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Функция используется совместно с объектом XML или объектом ветки XML и возвращает объект подчиненной ветки по ее имени. Наименования веток ищутся с учетом регистра. Если в искомом имени не задано пространство имен, ищется ветка с любым пространством имен с совпадающим именем. Чтобы форсировать поиск веток без пространств имен в этом случае, необходимо указать в искомом имени пустое пространство имен (:<Имя ветки>
).
Синтаксис
XML.ByName(<Имя ветки с или без пространства имен (STRING)>,<Индекс среди одинаковых имен (INT)>=1):<Объект вложенной ветки (XMLBRANCH)>
Аргументы
<Имя ветки с или без пространства имен (STRING)>
- Аргумент задает имя подчиненной ветки для поиска. Формат задания имени влияет на то, будут ли при поиске учитываться пространства имен. Формат может быть следующим:- имя ветки без пространства имен (к примеру, tag) -- поиск будет происходить для имен веток с любым пространством имен или без пространства имен вообще (т.е. для tag будут найдены tag, ns1:tag и т.п.).
- имя ветки с пространством имен (к примеру, ns1:tag) -- поиск будет происходить для имен веток с указанным пространством имен (т.е. для ns1:tag не будут найдены tag, ns2:tag и т.п.).
- имя ветки с пустым пространством имен (к примеру, :tag) -- поиск будет происходить для имен веток без пространства имен, имена веток с пространствами имен будут пропускаться при поиске (т.е. для :tag не будут найдены ns1:tag, ns2:tag и т.п.).
<Индекс среди одинаковых имен (INT)>
- (необязательный аргумент) Аргумент дополнительный цифровой индекс ветки среди веток с тем же именем. По умолчанию, возвращается первая найденная ветка.
Возвращаемое значение
Возвращает объект найденной ветки.
Примеры
aObject:=XML.create(); Стр:=aObject.LoadFromFile("c:\file.xml",65001); If not IsEmpty(Стр) Then Message("Найдены ошибки при загрузке файла:"+_NEWLINE+Стр); Exit; EndIf; //Вывод информации по ветке <data> подчиненной корневой ветке. aNode:=aObject.Root.ByName(":data"); Message(aNode.FullName+?(_And(aNode.Count()=0,aNode.Value<>"")," ---> """+aNode.Value+"""")+", Путь: "+aNode.Path);