XML.GetElementNames

table XML.GetElementNames ( string XMLPath,
boolean FullPaths = false,
boolean IncludeIndices = false )
Примеры

Описание

Возвращает численно индексированную таблицу, содержащую имена всех дочерних элементов, имеющихся внутри указанного элемента.

Примечание: Для получения дополнительной информации о действиях XML смотрите тему Общее представление о действиях XML.

Параметры

XMLPath

(строка) Полный путь к элементу, чьи дочерние элементы нужно найти.

FullPaths

(логический) Возвращать ли полные пути к дочерним элементам или только имена элементов:

ЗНАЧЕНИЕ
VALUE
ОПИСАНИЕ
DESCRIPTION
trueВозвращать полные пути к дочерним элементам.
falseВозвращать только имена элементов. (По умолчанию)

IncludeIndices

(логический) Добавлять ли к каждому имени элемента разделитель и индекс (например, ":3"):

ЗНАЧЕНИЕ
VALUE
ОПИСАНИЕ
DESCRIPTION
trueДобавлять к каждому имени элемента разделитель и индекс.
falseВозвратить только имена элементов. (По умолчанию)

Возврат

ResultVariable

(таблица) Численно индексированная таблица, содержащая имена всех дочерних элементов, имеющихся внутри указанного элемента. Если дочерних элементов нет или происходит ошибка, возвращается значение nil. Можно использовать действие Application.GetLastError для определения случился ли отказ в работе этого действия и почему.

При добавлении действия из редактора скрипта, можно использовать это поле для определения переменной, которая возвращает значение, сохраняющееся в ней.
Смотрите также: Связанные действия

Примеры

Пример 1

-- This example assumes the sample XML is already loaded into memory.
-- В этом примере предполагается что образец XML уже загружен в память.

-- Return the names of all of the child elements of address_info.
-- Возвращаем имена всех дочерних элементов address_info.
tbChild_elements = XML.GetElementNames("database/customer/address_info", false, true);

-- Perform some error checking.
-- Выполняем одну проверку на ошибки.
error = Application.GetLastError();
-- If no errors occurred...
-- Если ошибки не было...
if (error == 0) then
    if (tbChild_elements ~= nil) then

        -- Convert the table to a return/newline delimited string to display in a dialog.
        -- Конвертируем таблицу в строку с разделителями, где каждое возвращенное значение написано с новой строки, для отображения в диалоговом окне.
        strChild_elements = Table.Concat(tbChild_elements, "\r\n", 1, TABLE_ALL);

        -- Display a dialog message containing all child names.
        -- Показываем окно сообщения со всеми именами дочерних элементов.
        Dialog.Message("Child Element Names", strChild_elements);
    end
else
    Dialog.Message("Error", _tblErrorMessages[error]);
end
Получаем имена всех дочерних элементов "addresss_info" включая индексы и показываем их в диалоговом окне сообщения.
Смотрите также: Связанные действия