FTP文件上传控件开发文档-Xproer.FtpUploader2
版权所有 2009-2012 武汉命运科技有限公司保留所有权利
产品博客：http://www.iyunv.com/xproer/
官方网站：http://www.ncmem.com/
产品首页：http://www.ncmem.com/webplug/ftp-uploader2/index.aspx
在线演示：http://www.ncmem.com/products/file-uploader/demo/index.html
开发文档：http://www.iyunv.com/xproer/archive/2011/03/15/1984413.html
升级日志：http://www.iyunv.com/xproer/archive/2011/04/04/2005251.html
资源下载：cab安装包,开发文档,示例下载,VC库
联系信箱：1085617561@qq.com
联系QQ：1085617561
1. 概述
FtpUploader2在FtpUploader的基础上进行了大幅度调整和优化。
首先在FtpUploader中是使用单独的线程来计算即时上传速度的，在某些情况下计算结果可能会出现较大的误差。在FtpUploader2中我们取消了单独的速度计算线程，将速度计算与上传模块整合在一起，使速度计算更加精确。
在客户端调用方面(JavaScript)我们在COM组件中提供了一个JS对象指针，用来保存客户端的FtpUploader对象，在组件事件中将这个JS对象指针传给客户端，这样极大的简化了客户端开发模式。
在即时速度计算方面，我们取消了JS的定时调用，装饰速度计算的任务完全交给COM组件来进行。降低了线程同步访问的风险。
与FtpUploader相比FtpUploader2更稳定，更高效，开发也更简单。
2. 快速开始
2.1. 架设FTP服务器
新颖网络FTP文件上传插件支持Microsoft FTP，Serv-U和FileZilla。
以下分别为FTP服务器的架设教程：
安装ServU—7.1：http://www.iyunv.com/xproer/archive/2010/11/20/1882370.html
安装ServU-6.4.0.6：http://www.iyunv.com/xproer/archive/2011/03/28/1998042.html
安装FileZilla Server：http://www.iyunv.com/xproer/archive/2010/12/23/1914588.html
安装Microsoft FTP Server：http://www.iyunv.com/xproer/archive/2011/03/06/1972192.html
2.2. 添加测试帐号
由于测试版FtpUploader只能连接127.0.0.1服务器，且只能以test帐号登陆，所以在演示时需要添加test帐号。
帐号：test
密码：test
2.3. 配置FTP信息
var manager = new FileTransferManager("FilePostLister");
manager.Config["Server"] = "127.0.0.1";//测试版插件只能连接这个IP
manager.Config["UserName"] = "test";//设置FTP用户名
manager.Config["UserPass"] = "test";//设置FTP密码
manager.Config["RemoteFolder"] = "upload";//设置FTP上传目录
2.4. 运行示例
在IE中打开文件FtpUploader.html
3. JavaScript对象
3.1. FileUploader对象
类型：JavaScript
文件上传对象的包装类，用户在实际的项目中只需要创建FileUploader对象，然后通过FileUploader对象就可以进行文件上传操作。
语法：
JavaScript（声明）
function FileUploader() { }
方法
名称
说明
Ready
指示文件上传对象准备完毕
Post
开始上传文件
Stop
停止文件上传
PostNext
继续传输上传队列中的下一个文件
Ready方法
将上传任务状态设置为准备状态。
Post方法
开始上传文件。
说明：此函数将会自动实现断点续传功能。如果当前任务文件只上传了一半，则在下次开始时XSUploader组件将会自动定位到上次上传的位置继续上传数据。
Stop方法
停止上传任务。
PostNext方法
继续上传队列中下一个任务。
属性
名称
说明
pMsg
消息对象。是一个DIV
pProcess
上传进度条对象。是一个DIV
pPercent
上传进度百分比对象。是一个DIV
pButton
控制按钮对象。是一个A
LocalFile
包含完整路径的本地文件名称。例：C:\qq.exe
3.2. FileTransferManager对象
类型：JavaScript
文件上传管理类。
构造函数
FileTransferManager(fileListDivId)
参数：
fileListDiv
上传列表的DIV对象ID名称。文件上传管理对象会将每一个文件的上传信息添加到此DIV中。
注意：此DIV必须存在，此DIV的ID必须唯一。
方法
AddFile方法
添加一个文件到上传对列中
语法：
void AddFile(fid);
参数：
fid
新上传任务的文件ID，此ID用来区域不同的上传任务。必须保证唯一。
PostFirst方法
开始上传队列中的第一个文件。
语法：
void PostFirst()
Exist方法
检查上传队列中是否存在指定文件。
语法：
bool Exist();
返回值：
true
表示存在。
false
不存在。
说明：此函数是根据本地文件的完整路径来检测的。
属性
Config属性
提供插件的全局配置信息。在项目如果需要修改插件的配置信息，只需要通Config属性来控件即可。
语法：
this.Config = {
"Server" : "127.0.0.1"
, "UserName": "test"
, "UserPass": "test"
, "RemoteFolder": ""
, "Port" : 21
};
示例-设置插件信息
var manager = new FileTransferManager("FilePostLister");
manager.Config["Server"] = "tel.ftp.u.115.com:21";
manager.Config["UserName"] = "1199925";
manager.Config["UserPass"] = "4b29da413f";
manager.Config["RemoteFolder"] = "upload";
4. ActiveX对象
4.1. Xproer.UploaderPartition2对象
CLSID：9463F939-F485-404f-9FB0-8729E82DE11F
类型：ActiveX
多文件选择对象。弹出一个文件选择对话框，为用户提供选择多个文件的功能。
方法
名称
说明
ShowDialog
弹出文件选择对话框
GetSelectedFiles
获取用户选择的文件列表
GetSelectedFiles方法
获取用户选择的文件列表数组。
示例
下面的代码示例将会创建一个文件选择框，并弹出用户所选择的文件名称。
JavaScript：
function ShowSelectFileDlg()
{
var manager = new FileTransferManager("FilePostLister");
var obj = new ActiveXObject("Xproer.UploaderPartition2");//创建文件选择对话框
if (!obj.ShowDialog()) return;
var list = obj.GetSelectedFiles();//获取用户选择的文件
if (list.lbound(1) == null) return;
for (var index = list.lbound(1); index
var obj = document.getElementById("FilePanel1");
obj.OnFileDrop = EventFileDrop;
function EventFileDrop()
{
var lister = document.getElementById("divFileLister");
var list = obj.GetSelectedFiles();//获取选择的文件
for (var index = list.lbound(1); index
页:
[1]