版权所有 2009-2013 武汉命运科技有限公司
保留所有权利
官方网站:http://www.ncmem.com
官方博客:http://www.cnblogs.com/xproer
产品首页:http://www.ncmem.com/webplug/image-uploader/
产品介绍:http://www.cnblogs.com/xproer/archive/2010/08/09/1796077.html
在线演示-标准版:http://www.ncmem.com/products/image-uploader/demo/index.html
在线演示-专业版:http://www.ncmem.com/products/image-uploader/demo-pro/index.html
在线演示-高级版:http://www.ncmem.com/products/image-uploader/demo-pre/index.html
布署文档:http://www.cnblogs.com/xproer/archive/2011/09/14/2176188.html
升级日志:http://www.cnblogs.com/xproer/archive/2010/12/04/1896399.html
开发文档-PHP:http://www.cnblogs.com/xproer/archive/2011/05/13/2045854.html
开发文档-JSP:http://www.cnblogs.com/xproer/archive/2011/05/20/2051887.html
资源下载-标准版:CAB安装包,开发文档,ASP示例,ASP.NET示例,JSP示例(GB2312),JSP示例(UTF8),PHP示例
示例下载-企业版:ASP示例,ASP.NET示例,JSP示例,PHP示例,
联系邮箱:1085617561@qq.com
联系QQ:1085617561
1. 搭建测试环境
1.1. ASP.NET
1. ImageUploader用户接口
1.1. 设置服务器编码
说明:
控件的编码格式必须与服务器对应,服务器的编码格式是是UTF-8控件的格式也必须是UTF-8,如果服务器是GB2312那么控件也必须是GB2312。否则服务器接受的字符串将会产生乱码。
var ImageUploader = new ImageUploader ("acxImageUploader");//控件object对象的ID
ImageUploader.Config["EncodeType"] = "GB2312";//上传页面的编码格式为GB2312
1.2. 图片上传地址
var ImageUploader = new ImageUploader ("acxImageUploader");//控件object对象的ID
ImageUploader.Config["PostUrl"] = "http://www.ncmem.com/upload.aspx";//设置图片上传地址。
1.3. 缩略图
1.3.1. 配置控件自动生成缩略图
说明:
控件会根据用户设置的尺寸生成缩略图并上传到服务器中。
var ImageUploader = new ImageUploader ("acxImageUploader");//控件object对象的ID
ImageUploader.Config["ThumbWidth"] = 100;//将缩略图宽度设为100
ImageUploader.Config["ThumbHeight"] = 100;//将缩短略图高度设为100
1.4. 图片格式转换
说明:
图片格式转换是指将控件中的所有图片批量转换为指定格式,并上传到服务器中。
var ImageUploader = new ImageUploader ("acxImageUploader");//控件object对象的ID
ImageUploader.Config["ImageUploadType"] = "JPG";//将图片类型设为JPG,在上传前所有图片格式将会被转换为JPG格式。
1.5. 设置附加信息
说明:
附加信息的作用是在上传图片的同时向服务器提交自定义信息。比如服务器需要知道是哪一个用户上传的图片,这时可以将用户ID添加到附加信息,然后再上传到服务器。服务器可以根据用户ID来区分是哪一个用户上传的图片。
JavaScript
var ImageUploader = new ImageUploader ("acxImageUploader");
ImageUploader.Fields["UserName"] = "test";
ImageUploader.Fields["UserID"] = "100";
ImageUploader.Fields["Remark"] = "描述字段";//支持中文,控件会自动对中文进行UrlEncode编码,服务器应该对数据进行UrlDecode解码。
ImageUploader.Init();
ASP.NET(C#)
string fname = Request.Form["UserID"];
string remark = Request.Form["Remark"];
remark = Server.UrlDecode(remark);//控件会自动对中文字段进行UrlEncode编码,服务器应该对数掘进行UrlDecode解码
1.6. 设置默认打开的文件夹
说明:
设置默认打开的文件夹完整路径后,当用户点击“添加图片”按钮时控件将会自动打开设置的文件夹。
var ImageUploader = new ImageUploader ("acxImageUploader");
ImageUploader.SetDefaultFolder("E:\\图像资源\\aaa");//
ImageUploader.Init();
1.7. 获取上传完的图片地址
上传控件提供了一个AfterImagesPosted事件,开发人员只需要为此事件指定一个函数指针,这样开发人员就能够自定义处理图片上传完成后的逻辑。
注意:
在IE6和IE7浏览器中,当控件将所有图片上传完毕后请不要立即进行跳转的操作,立即跳转操作可能导致浏览器被锁住。这个问题是由于IE6浏览器没有处理控件回调通知消息导致的。
如果需要在所有图片上传完毕后进行跳转链接操作,请使用定时器实现。一般将时间设为1秒钟
//所有图片传输完毕
function AfterImagesPosted(obj)
{
var imgs = obj.Com.GetPostedFiles();
if (imgs == null) return;
var strImgs = new Array();
for (var index = imgs.lbound(1); index <= imgs.ubound(1); index++)
{
strImgs.push(imgs.getItem(index));
}
//在IE6或IE7中如果希望在所有图片上传完后进行跳转链接操作,应该使用定时器来实现。
setTimeout("http://www.ncmem.com/",1000);
}
//跳转链接
function GoToUrl(url)
{
window.location.href = url;
}
2. JavaScript对象
2.1. ImageUploader对象
类型:JavaScript
图片上传插件的封装类。提供图片上传插件的信息配置及初始化功能。
方法
Init方法
初始化图片上传插件。
语法
void Init();
属性
Fields属性
上传时附加的额外信息。
注意:此属性暂时不支持中文字符串。
以下示例演示上传时添加用户名和密码的额外信息:
var ImageUploader = new ImageUploader ("acxImageUploader");
ImageUploader.Fields["UserName"] = "test";
ImageUploader.Fields["UserPass"] = "test";
Config属性
提供全局配置信息。
语法:
this.Config = {
"EncodeType" : "UTF-8"
,"PostUrl" : "http://www.ncmem.com/upload.aspx"
};
3. ActiveX对象
3.1. XproerWebPlug.ImageUploader对象
CLSID:FB
类型:ActiveX
图片上传插件。