使用 IntraWeb (24) - 基本控件之 TIWFileUploader、TIWFile

TIWFileUploader 是基于 Ajax 的上传控件, 最初是 Andrew Valums 开发, 从 IntraWeb XIV 纳入并替换 TIWFile.

虽然从组件面板上还能看到 TIWFile, 官方说已不能使用.

现在的 TIWFileUploader 非常方便, 能拖拽上传, 能批量上传, 会自动显示上传进度, 界面也可以很漂亮.

我测试拖拽上传时, 发现有些浏览器不支持.

---

TIWFileUploader 所在单元及继承链:
IWCompFileUploader.TIWFileUploader < TIWCustomFileUploader < TIWCustomControl < TIWBaseHTMLControl < TIWBaseControl < TIWVCLBaseControl < TControl < TComponent < TPersistent < TObject

主要成员:

---

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;

---

转帖几张官方的图片吧:

---

---

---

---

---

---