File.LoadFileNames

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

Функция получает список файлов выборки с указанным путем и маской. Функция используется как альтернатива функциям FindOpen и FindNextFile. Однако, для очень больших выборок, она может выполняться долгое время, тогда как FindNextFile получает информацию порциями, что может быть выгоднее для индикации процесса работы. Наименования папок также возвращаются вместе с именами файлов, если папки подпадают под маску поиска.

Синтаксис

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

Аргументы

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

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

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

Примеры

Function ПостроитьСписокНастроек()
  Сп:=List.Create();
  Путь:="Temp\Бухгалтерия\Баланс";
  If not File.DoesPathExist(Путь) Then
    File.CreateDirectory(Путь);
  EndIf;
  Сп:=File.LoadFileNames(Путь+"\*.set");
  For i:=1 To Сп.Size() Do
    Сп.SetName(i,RemoveExt(Сп.GetName(i)));
  EndDo;
  Exit Сп;
EndFunction