TIWFileUploader 是基于 Ajax 的上传控件, 最初是 Andrew Valums 开发, 从 IntraWeb XIV 纳入并替换 TIWFile.
虽然从组件面板上还能看到 TIWFile, 官方说已不能使用.
现在的 TIWFileUploader 非常方便, 能拖拽上传, 能批量上传, 会自动显示上传进度, 界面也可以很漂亮.
我测试拖拽上传时, 发现有些浏览器不支持.
TIWFileUploader 所在单元及继承链:
IWCompFileUploader.TIWFileUploader
主要成员:
property MaxFileSize: Int64 //文件最大许可, 默认 20971520(20MB); 如果为 0, 则表示没有最大限制
property MinFileSize: Int64 //文件最小许可, 默认 0, 表示没有最小限制
property Multiple: Boolean //是否支持多个文件同时上传, 默认 False
property AutoHideListTime: Cardinal //上传后等待多少毫秒既隐藏上传列表; 默认 0, 表示不隐藏.
property TextStrings: TIWFileUploaderTextStrings //这包含 12 项信息文本, 可以通过它彻底地本地化
property Style: TIWFileUploaderStyle //它包含 7 个子选项, 可设置各种状态下的样式, 能弄得很漂亮
property AllowedExtensions: string //支持上传的文件类型, 多种类型用逗号分割, 如: rar,zip,pdf,mp3; 默认为空, 表示支持任何文件
property AutoSave: Boolean //上传完成后是否自动保存到 AutoSavePath 指示的文件夹
property AutoSavePath: string //用于自动保存的文件夹, 如果不存在会创建; 如果出错会保存在用户的缓存文件夹
property OverwriteExisting: Boolean //是否覆盖同名文件, 默认 True; False 时遇同名会引发异常
property DisableCancel: Boolean //在上传过程中, 是否禁用"取消", 默认 False
property FileList: THttpFileList //?
property AcceptFiles: string //?
property OnAsyncUploadCompleted: TUploadCompleteEvent //该事件在上传完毕后自动保存前触发; 可以在该事件中更改路径或文件名, 甚至取消保存
property OnAsyncUploadSuccess: TIWAsyncEvent //成功完成后
property OnAsyncUploadError: TIWAsyncEvent //出错时
{下面三个保存方法都应该用在 OnAsyncUploadCompleted 中}
function SaveAll(APathname: string; AOverwrite: Boolean) //如果还是使用源文件名, 应该用这个
function SaveToFile(ASourceFileName: string; ADestFileName: TFileName; AOverwrite: Boolean) //假如要更改文件名, 用这个
function SaveToStream(ASourceFileName: string; AStream: TStream) //
procedure NotifyUploadCompleted //
测试 1(全自动上传):
uses ServerController; procedure TIWForm1.IWAppFormCreate(Sender: TObject); begin IWFileUploader1.MaxFileSize := 0; //不限制大文件 IWFileUploader1.Multiple := True; //可以同时上传多个文件 IWFileUploader1.AutoSave := True; //自动保存 IWFileUploader1.AutoSavePath := IWServerController.ContentPath; //这是 wwwroot, 需要修改文件夹属性, 可写才行 end;
测试 2(在 OnUploadCompleted 事件中保存):
uses ServerController; procedure TIWForm1.IWAppFormCreate(Sender: TObject); begin IWFileUploader1.MaxFileSize := 0; IWFileUploader1.Multiple := True; IWFileUploader1.AutoSavePath := IWServerController.ContentPath; end; //OnUploadCompleted 的参数解释: //DestPath 同 AutoSavePath //FileName 同源文件名 //SaveFile 它会是 True, //Overwrite 同 OverwriteExisting procedure TIWForm1.IWFileUploader1AsyncUploadCompleted(Sender: TObject; var DestPath, FileName: string; var SaveFile, Overwrite: Boolean); begin IWFileUploader1.SaveAll(DestPath, Overwrite); SaveFile := False; //如果前面设置了自动保存, 就取消它 end;
转帖几张官方的图片吧:
使用 IntraWeb (24) - 基本控件之 TIWFileUploader、TIWFile,布布扣,bubuko.com