Difference between revisions of "ExternalObject.LoadFileNames"

From SunFlurry wiki
Jump to: navigation, search
1>Admin
 
m (1 revision imported)
 
(No difference)

Latest revision as of 08:42, 27 November 2023

  LoadFileNames (Работа с внешними объектами)
Объект:Внешний загружаемый объект
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в строку, число
Визуальность:Нет

Функция получает список файлов внутри загруженного внешнего объекта с указанным путем и маской. Результатом действия функции является список, аналогичный получаемому из функции File.LoadFileNames, однако, в списоке будут отсутствовать папки, он будет содержать только файлы. При указании пути используется разделитель /, начальная часть пути Modules/FreeForms обязательна к указанию, если файл находится внутри этой ветки (к примеру: Modules/FreeForms/Таблицы/Table.sft).

Синтаксис

ExternalObject.LoadFileNames(<Путь и маска для выборки файлов (STRING)>,<Включать вложенные папки (INT)>=0):<Список с файлами выборки (LIST)>

Аргументы

  • <Путь и маска для выборки файлов (STRING> - Путь и маска для выборки файлов внутри загруженного внешнего объекта.
  • <Включать вложенные папки (INT)> - (необязательный аргумент) Аргумент позволяет задать режим, когда выборка файлов будет производиться не только в указанной папке, но и во всех подчиненных папках. По умолчанию режим отключен (0).

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

Возвращается список файлов. Наименованиями элементов списка служат имена файлов (или папок) без пути. Значения элементов содержат полную информацию по файлу, информация представлена в виде строки: <Путь/><Имя>Chr(1)<Размер файла в байтах>Chr(1)<0>.

Примеры

//Вывести список всех файлов произвольного внешнего объекта
ИмяФайла:="c:\Обработки\Вычислить.sfo";

аОбъект:=ExternalObject.Load(ИмяФайла);
aList:=аОбъект.LoadFileNames("*.*",1);
Message("Текущий объект содержит следующие файлы:");
For i:=1 To aList.Size() Do
  Message(TearStr(aList[i],Chr(1)));
EndDo;