Подключение, свойства, методы, взаимодействие со списками, изменение файлов

FileControl - это контрол для работы с файлами, дающий следующую функциональность:

• выбор файла из каталога (при этом создаётся копия содержимого файла, с которым и работает приложение).
• сохранение файла в каталог.
• удаление файла.
• запуск файла (файл открывается в ассоциированном с ним приложении).

Подключение FileControl к приложению

Для работы FileControl необходима ICSSoft.STORMNET.FileType.dll (есть в стандартной поставке Flexberry Winforms).

Чтобы подключить FileControl к проекту, необходимо выполнить следующее:

• Определить на диаграмме классов класс File со стереотипом typedef.

• Настроить карту типов (ORM -> C# -> Свойства модели -> Карта типов), добавив строку:

File | ICSSoft.STORMNET.FileType.File | ICSSoft.STORMNET.UserDataTypes.dll

• Настроить карту отображения типов (ORM -> SQL -> Microsoft SQL Server -> Настройка БД -> Карта типов), добавив строку:

File | TEXT

Свойства и методы FileControl

Как показать/скрыть кнопки на FileControl

У контрола есть свойства, позволяющие показывать/скрывать кнопки изменением их на false или true.

ctrlФайл.HideOpenButtons = false; //показать кнопку выбора файла из каталога
ctrlФайл.HideSaveButtons= false; //показать кнопку сохранения файла в каталог
ctrlФайл.HideDeleteButtons = false; //показать кнопку удаления файла
ctrlФайл.HideStartButtons = false; //показать кнопку запуска файла (открытия в ассоциированном приложении)

По умолчанию все кнопки на контроле на форме редактирования скрыты.

Другие свойства и методы

Свойство	Тип	Описание
ButtonChooseFileFromFolder	Button	Кнопка выбора файла из каталога
ButtonSaveFileToFolder	Button	Кнопка сохранения файла в каталог
ButtonDelete	Button	Кнопка удаления файла
ButtonOpenFile	Button	Кнопка запуска файла (открытия в ассоциированном приложении)
GetDisplayValue	string	Получение отображаемого значения для поля GroupEdit, с которым связан контрол; предусмотрена возможность пустых значений
InnerFile	MemoryStream	Поле, где хранится файл без zip-архивации
ToolTipControl	ToolTip	Контрол, отвечающий за тултипы
Value	object	Поле, где хранится файл с zip-архивацией

Метод	Тип возвращаемого значения	Описание
GetDisplayValue	string	Получение отображаемого значения для поля GroupEdit, с которым связан контрол; предусмотрена возможность пустых значений

FileControl и формы списка

Important: Не рекомендуется включать поля, обрабатываемые с помощью FileControl, в представления, обрабатываемые на форме списка, поскольку в этом случае при просмотре списка в память грузятся все файлы (кроме того, не гарантируется, что отображаемое имя файла будет осмысленным).

Изменение открытых через FileControl файлов

Если в открытые через FileControl файлы внести изменения во внешней программе (не в ту версию, что лежит в каталоге, откуда взят файл, а ту, что находится в FileControl), то файл в FileControl автоматически обновится.