SysGetFiles

<< Click to Display Table of Contents >>

Navigation:  Проект в MasterSCADA 4D > Дерево библиотек > Библиотека BaseObjects > BaseObjects.ФБ.Системные > Работа с файлами >

SysGetFiles

Функциональный блок SysGetFiles служит для получения списка рабочих папок или файлов по заданному пути.

Важно! Для возможности работы c ФБ SysGetFiles в исполнительную систему должна входить опция MSRT4D-FileWork. Данная опция включена в базовый функционал лицензий Professional и Enterprise.

Этот функциональный блок может использоваться как самостоятельно, вне программ, так и в составе любой программы.

Важно! Данный ФБ не будет будет исполняться в задаче экрана.

Находится в библиотеке BaseObjects.

Вид в дереве

Вид в редакторе FBD

SysGetFiles

SysGetFiles_1

Входы и выходы ФБ:

Название

Тип

Назначение

Входы

Path

STRING

Задается путь к папке из содержимого которой будет формироваться список. Можеть быть абсолютным или относительно рабочей папки.

Wildcard

STRING

Задается шаблон для выбора файлов или папок из которых будет формироваться список при помощи знака *, существует четыре варианта использования шаблона:

*, в этом случае в список будут добавлены все файлы или папки

*.txt, в этом случае в список будут добавлены все файлы с заданным расширением (в данном случае файлы с расширение .txt)

*1*, в этом случае в список будут добавлены все папки и файлы содержащие 1 в названии

*1.txt, в этом случае в список будут добавлены все файлы оканчивающиеся на 1 с заданным расширением (в данном случае файлы с расширение .txt)

Выходы

ErrorText

STRING

Выдается текст ошибки, если не удалось сформировать список.

Files

ARRAY [*] OF FileInfo

Выдается описание по каждому добавленному файлу или папки в список. Выход представляет собой массив структур. Каждый элемент массива соотвествует добавленному файлу или папки. Каждая структура содержит следующие поля:

Name - имя добавленного файла или папки, STRING

FullName- полное имя добавленного файла или папки с путем до него, STRING

IsFolder - тип элемента, BOOL. Если TRUE, то это папка. Если FALSE, то это файл

Size - размер файла или папки, LINT

Time - время последнего изменения, STRING

 

Вспомогательные типы данных находятся в библиотеке BaseObjects.Типы данных:

SysGetFiles_2

Смотрите также: