FileUpload#
FileUpload - Контрол, позволяющий пользователю загружать и скачивать файлы с сервера.
Свойства#
bind#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| string | - |
Свойство, к которому биндится контрол
caption#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| string | - |
Заголовок контрола
captionTextAlign#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| string | left | left/right |
Выравнивание текста заголовка контрола.
captionWidth#
Ширина заголовка в колонках (для Bootstrap-верстки).
отнаследовано от Control
denyRoles#
Список ролей без прав на данный элемент.
Отнаследовано от Control.
editorWidth#
Ширина контрола в колонках (для Bootstrap-верстки).
отнаследовано от Control
fileId#
| тип | значение по умолчанию | допустимые значения |
|---|---|---|
| string | - |
Уникальный идентификатор, использующийся для составления url, по которому будет загружен файл.
Если у контрола не задано свойство fileId, то он отображает сообщение, при нажатии на которое отображается системный диалог выбора файлов. При выборе нужного файла он автоматически сохраняется в базу данных приложения и ему присваивается уникальный идентификатор, который затем устанавливается в соответствующее свойство контрола.
hint#
Всплывающая подсказка, которая появляется при наведении на контрол.
Отнаследовано от Control.
id#
Идентификатор контрола.
Отнаследовано от Control.
readRoles#
Список ролей на чтение данных.
отнаследовано от Control.
storage#
Указывается имя хранилища из конфигурационного файла (gate.storages).
В это хранилище будет сохраняться файл. Если storage не задан, то используется хранилище по умолчанию (определяется по настройке gate.storage).
tags#
Позволяет объединять контролы в группы, возвращает массив имен.
Отнаследовано от Control.
visible#
Видимость контрола.
Отнаследовано от Control.
writeRoles#
Список ролей на изменение данных.
отнаследовано от Control.
width#
Ширина контрола.
Отнаследовано от Control.
Методы#
choose#
См метод choose (КлассFileUpload)
События#
valueChanged#
Происходит при изменении значения
Пример
Поведение#
Загрузка файла осуществляется с помощью кнопки "Выбрать файл", по нажатию которой открывается диалог выбора файла. Сразу после выбора начинается отправка файла на сервер. После окончания загрузки сформируется ссылка на скачивание файла. Удалить файл или отменить загрузку можно нажав на крестик.
Сохранение файла#
Предполагается, что при загрузке пользователем файла оно сохраняется в БД с уникальным идентификатором (GUID) в качестве имени, передающемся затем в свойство fileId контрола.
Для привязки контрола к модели данных используется кастомный биндинг fileId. Типом свойства модели должен быть тип File.
Примеры#
Пример