HTTP文件上传插件开发文档-ASP

官方网站：http://www.ncmem.com/

产品首页：http://www.ncmem.com/webplug/http-uploader2/index.asp

在线演示：http://www.ncmem.com/products/http-uploader2/index.asp,

开发文档：asp,jsp,php,asp.net,

升级日志：http://www.cnblogs.com/xproer/archive/2011/03/15/1985091.html

资源下载：cab安装包(x86),cab安装包(x64),crx安装包,crx(nat)安装包,xpi安装包,exe安装包,开发文档,VC运行库,证书补丁,

示例下载：ASP示例,ASP.NET示例,JSP示例,PHP示例,

联系信箱：1085617561@qq.com

联系QQ：1085617561

更新记录：

更新时间	描述
2012-05-29	更新JSP文件上传示例代码。
2012-08-30	增加创建文件夹和删除文件示例代码。
2012-09-10	增加验证本地文件是否存在的示例代码，更新创建文件夹示例代码。
2014-03-18	完善正式包布署章节增加在本地运行DEMO章节增加在测试服务器中运行DEMO章节删除测试包布署说明章节。新增ASP测试章节。

1. 在本地运行DEMO

1.1. ASP

1.在IIS中新建站点

2.修改上传地址

2. 在测试服务器中运行DEMO

说明：如果客户端能够正常访问互联网，则不用在测试服务器中布署控件包。

步骤如下：

1.将控件包(HttpUploader.cab,HttpUploader64.cab)布署在测试服务器中

HttpUploader.cab为IE(x86)浏览器控件安装包。

HttpUploader64.cab为IE(x64)浏览器控件安装包。

2.修改up2.js中的控件包地址。

3.将上传地址改为测试服务器的上传地址。

3. 正式包布署说明

说明：在购买后我们会以邮件方式提供控件包文件。

1.将HttpUploader.cab,HttpUploader64.cab,HttpUploader2.xpi,HttpUploader2.crx,HttpUploader2.exe上传到正式服务器中。

HttpUploader.cab为IE(x86)浏览器控件安装包。

HttpUploader64.cab为IE(x64)浏览器控件安装包。

HttpUploader2.xpi为Firefox浏览器控件安装包。

HttpUploader2.crx为Chrome浏览器控件安装包。

HttpUploader2.exe为控件集成安装包。

2.修改up2.js文件中的配置信息。

3.1. 修改版本号

3.2. 修改IE32控件Clsid值

3.3. 修改IE32控件cab包地址

3.4. 修改IE64控件clsid值

3.5. 修改IE64控件cab包地址

3.6. 修改IE32，IE64控件ProjID信息

3.7. 修改Firefox控件XpiType值

3.8. 修改Firefox控件xpi包地址

3.9. 修改chrome控件CrxType和CrxName值

3.10. 修改Chrome控件crx包地址

3.11. 修改exe包地址

4. 整合到现有系统中

主要步骤：

1.上传js文件夹,控件包

2.在引用页面添加js引用

3.在引用页面编写控件初始化代码，并设置上传地址。

1.上传js文件夹

2.在引用页面添加js引用

3.编写控件初始化代码

5. 自动拼接路径

如果域名会经常变动不是固定域名，可以使用自动拼接路径函数InitPath()来简化控件布署。InitPath()函数的主要作用就是帮助开发人员拼接字符串。开发人员也可以根据自已的业务逻辑情况来修改此函数。

以下示例演示如何使用自动拼接路径

修改HttpUploader.js中的路径

：在引用页面设置上传地址

方法2：在up2.js中设置上传地址。

注意：如果同时在引用页面和up2.js中配置了上传地址，那么引用页面的设置将会覆盖up2.js中的设置，即只有引用页面的设置有效。

7.2. 设置服务器编码方式

var fileMgr = new HttpUploaderMgr();

fileMgr.Config["EncodeType"] = "GB2312";//设置上传编码。必须与网站配置相同。建议在HttpUploader.js中设置，这样可以在多个页面引用，而不需要再次设置。

$(document).ready(function ()

{

fileMgr.Load();

});

</script>

7.3. 设置文件类型

var fileMgr = new HttpUploaderMgr();

//设置允许上传的文件类型，使用英文逗号分(,)隔。如果允许所有的文件类型，则使用*

fileMgr.Config["FileFilter"] = "jpg,png,bmp,gif,doc,pdf,txt";

$(document).ready(function ()

{

fileMgr.Load();

});

</script>

7.4. 设置附加信息

附加信息的作用就是在上传图片的同时向服务器提交额外的字段信息。比如当用户向服务器上传截图时，服务器需要知道是哪位用户上传的截图，这时可以将用户ID添加到附加信息中，这样服务器在获取截图信息的同时也能够根据附加信息知道是哪位用户上传的截图。

客户端：

fileMgr.Fields["UserName"] = "test";

服务端：

string fname = Request.Form["UserName"];

开发人员可以根据自已的业务需求来扩展附加信息：

客户端：

fileMgr.Fields["f1"] = "f1";

fileMgr.Fields["f2"] = "f2";

fileMgr.Fields["f3"] = "f3";

fileMgr.Fields["f4"] = "f4";

fileMgr.Fields["f5"] = "f5";

服务端(ASP.NET)：

string f1 = Request.Form["f1"];

string f1 = Request.Form["f2"];

string f1 = Request.Form["f3"];

string f1 = Request.Form["f4"];

string f1 = Request.Form["f5"];

7.5. 上传本地文件

使用步骤如下：

1.调用postLoc函数上传本地文件，注意路径需要使用双斜框(\\)

var fileMgr = new HttpUploaderMgr();

$(document).ready(function ()

{

fileMgr.Load();

fileMgr.postLoc("D:\\360safe-inst.exe", "upPnl");

});

</script>

7.6. 以压缩模式(zlib)上传

说明：开启压缩后，控件上传前会对文件进行zlib压缩操作，服务端接收到的数据需要进行解压操作。压缩后传输的数据量变小，可以有效的降低网络流量从而提高上传效率。此功能特别适合企业级文件传输环境。

7.7. 以gzip压缩模式上传

配置方法：

压缩效果对比：

1.对txt文件进行测试

原文件大小：91.7kb

提交数据：

gzip压缩模式：

压缩后：0.796kb

2.对exe文件进行测试

原文件大小：1049kb

提交数据：

gzip压缩模式：

压缩后：684.820kb

8. UI模板

您可以根据实际需求来修改以下模板。

HTML:

<div name="fileName" class="FileName top-space">HttpUploader程序开发.pdf</div>

</div>

</div>

</div>

9. 服务端支持

9.1. ASP

9.1.1. upload.asp文件

<% @Language=vbscript Codepage=936 %>

Option Explicit

Response.Buffer=True

dim lngUpSize,uploader,intError

Set uploader = new UpLoadClass

uploader.TotalSize= 10485760'10MB

uploader.MaxSize = 10000*1024

uploader.FileType = "gif/jpg/png/bmp/pdf/doc/xls/rar/zip/txt"

uploader.Savepath = "upload/"

'自动创建上传文件夹

dim folder,fs

folder = server.MapPath(uploader.Savepath)

set fs = Server.CreateObject("Scripting.FileSystemObject")

if(fs.FolderExists(folder) = false) then

fs.CreateFolder(folder)

end if

lngUpSize = uploader.Open()

intError = uploader.Form("photo2_Err")

response.Write("upload/" & uploader.Form("ServerFileName"))

if lngUpSize>uploader.MaxSize then

<!--

alert("您上传的文件最大不能超过10M!!");

history.back();

//-->

</script>

response.end

end if

if intError=-1 then

<!--

alert("您没有上传任何文件，请重新上传!!");

history.back();

//-->

</script>

response.end

end if

Set uploader = nothing