Admin: 1 revision imported

2021-06-28T07:06:21Z

1 revision imported

1>Admin: Created page with "{{infobox function |name=ByName |object=Объект XML |caption=Получение подчиненной ветки по имени |type=1 |status=2 |db=0 |exception=..."

2021-06-22T08:29:54Z

Created page with "{{infobox function |name=ByName |object=Объект XML |caption=Получение подчиненной ветки по имени |type=1 |status=2 |db=0 |exception=..."

New page

{{infobox function
|name=ByName
|object=[[Объект XML]]
|caption=Получение подчиненной ветки по имени
|type=1
|status=2
|db=0
|exception=Невозможно превратить в число, строку, ветка на найдена.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект XML]]}}
Функция используется совместно с объектом XML или объектом ветки XML и возвращает объект подчиненной ветки по ее имени. Наименования веток ищутся с учетом регистра. Если в искомом имени не задано пространство имен, ищется ветка с любым пространством имен с совпадающим именем. Чтобы форсировать поиск веток без пространств имен в этом случае, необходимо указать в искомом имени пустое пространство имен (<code>:<Имя ветки></code>).

== Синтаксис ==
<code>
{{Grey|XML.}}'''ByName'''(''<Имя ветки с или без пространства имен (STRING)>''{{Optional|,''<Индекс среди одинаковых имен (INT)>''{{Default|{{Eq}}1}}}}):''<Объект вложенной ветки (XMLBRANCH)>''
</code>

==== Аргументы ====
* <code>''<Имя ветки с или без пространства имен (STRING)>''</code> - Аргумент задает имя подчиненной ветки для поиска. Формат задания имени влияет на то, будут ли при поиске учитываться пространства имен. Формат может быть следующим:
** '''имя ветки без пространства имен''' (к примеру, ''tag'') -- поиск будет происходить для имен веток с любым пространством имен или без пространства имен вообще (т.е. для ''tag'' будут найдены ''tag'', ''ns1:tag'' и т.п.).
** '''имя ветки с пространством имен''' (к примеру, ''ns1:tag'') -- поиск будет происходить для имен веток с указанным пространством имен (т.е. для ''ns1:tag'' '''не''' будут найдены ''tag'', ''ns2:tag'' и т.п.).
** '''имя ветки с пустым пространством имен''' (к примеру, '':tag'') -- поиск будет происходить для имен веток без пространства имен, имена веток с пространствами имен будут пропускаться при поиске (т.е. для '':tag'' '''не''' будут найдены ''ns1:tag'', ''ns2:tag'' и т.п.).
* <code>''<Индекс среди одинаковых имен (INT)>''</code> - {{Optional}} Аргумент дополнительный цифровой индекс ветки среди веток с тем же именем. По умолчанию, возвращается первая найденная ветка.

==== Возвращаемое значение ====
Возвращает объект найденной ветки.

== Примеры ==
<pre>
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);
</pre>

← Older revision	Revision as of 07:06, 28 June 2021
(No difference)

XML.ByName - Revision history

Admin: 1 revision imported

1>Admin: Created page with "{{infobox function |name=ByName |object=Объект XML |caption=Получение подчиненной ветки по имени |type=1 |status=2 |db=0 |exception=..."