AspNet中使用JQuery上传插件Uploadify详解

更新时间：2015年05月20日 10:29:09 投稿：hebedich

Uploadify是JQuery的一个上传插件，实现的效果非常不错，带进度显示。不过官方提供的实例时php版本的，本文将详细介绍Uploadify在Aspnet中的使用

首先按下面的步骤来实现一个简单的上传功能。

1 创建Web项目，命名为JQueryUploadDemo，从官网上下载最新的版本解压后添加到项目中。

2 在项目中添加UploadHandler.ashx文件用来处理文件的上传。

3 在项目中添加UploadFile文件夹，用来存放上传的文件。

进行完上面三步后项目的基本结构如下图:

4 Default.aspx的html页的代码修改如下：

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>Uploadify</title>
  <link href="JS/jquery.uploadify-v2.1.0/example/css/default.css"
   rel="stylesheet" type="text/css" />
  <link href="JS/jquery.uploadify-v2.1.0/uploadify.css"
   rel="stylesheet" type="text/css" />

  <script type="text/javascript"
   src="JS/jquery.uploadify-v2.1.0/jquery-1.3.2.min.js"></script>

  <script type="text/javascript"
   src="JS/jquery.uploadify-v2.1.0/swfobject.js"></script>

  <script type="text/javascript"
  src="JS/jquery.uploadify-v2.1.0/jquery.uploadify.v2.1.0.min.js"></script>

  <script type="text/javascript">
    $(document).ready(function()
    {
      $("#uploadify").uploadify({
        'uploader': 'JS/jquery.uploadify-v2.1.0/uploadify.swf',
        'script': 'UploadHandler.ashx',
        'cancelImg': 'JS/jquery.uploadify-v2.1.0/cancel.png',
        'folder': 'UploadFile',
        'queueID': 'fileQueue',
        'auto': false,
        'multi': true
      });
    }); 
  </script>

</head>
<body>
  <div id="fileQueue"></div>
  <input type="file" name="uploadify" id="uploadify" />
  <p>
   <a href="javascript:$('#uploadify').uploadifyUpload()">上传</a>| 
   <a href="javascript:$('#uploadify').uploadifyClearQueue()">取消上传</a>
  </p>
</body>
</html>

5 UploadHandler类的ProcessRequest方法代码如下：

public void ProcessRequest(HttpContext context)
{
  context.Response.ContentType = "text/plain";  
  context.Response.Charset = "utf-8";  

  HttpPostedFile file = context.Request.Files["Filedata"];  
  string uploadPath = 
    HttpContext.Current.Server.MapPath(@context.Request["folder"])+"\\"; 

  if (file != null) 
  { 
    if (!Directory.Exists(uploadPath)) 
    { 
      Directory.CreateDirectory(uploadPath); 
    }  
    file.SaveAs(uploadPath + file.FileName); 
    //下面这句代码缺少的话，上传成功后上传队列的显示不会自动消失
    context.Response.Write("1"); 
  }  
  else 
  {  
    context.Response.Write("0");  
  } 
}

6 运行后效果如下图：

7 选择了两个文件后，点击上传，就可以看到UploadFile文件夹中会增加这两个文件。

上面简单地实现了一个上传的功能，依靠函数uploadify实现，uploadify函数的参数为json格式，可以对json对象的key值的修改来进行自定义的设置，如multi设置为true或false来控制是否可以进行多文件上传，下面就来介绍下这些key值的意思：

uploader ： uploadify.swf 文件的相对路径，该swf文件是一个带有文字BROWSE的按钮，点击后淡出打开文件对话框，默认值：uploadify.swf。
script ：后台处理程序的相对路径。默认值：uploadify.php
checkScript ：用来判断上传选择的文件在服务器是否存在的后台处理程序的相对路径
fileDataName ：设置一个名字，在服务器处理程序中根据该名字来取上传文件的数据。默认为Filedata
method ：提交方式Post 或Get 默认为Post
scriptAccess ：flash脚本文件的访问模式，如果在本地测试设置为always，默认值：sameDomain
folder ：上传文件存放的目录。
queueID ：文件队列的ID，该ID与存放文件队列的div的ID一致。
queueSizeLimit ：当允许多文件生成时，设置选择文件的个数，默认值：999 。
multi ：设置为true时可以上传多个文件。
auto ：设置为true当选择文件后就直接上传了，为false需要点击上传按钮才上传。
fileDesc ：这个属性值必须设置fileExt属性后才有效，用来设置选择文件对话框中的提示文本，如设置fileDesc为“请选择rar doc pdf文件”，打开文件选择框效果如下图：

fileExt ：设置可以选择的文件的类型，格式如：'*.doc;*.pdf;*.rar' 。
sizeLimit ：上传文件的大小限制。
simUploadLimit ：允许同时上传的个数默认值：1 。
buttonText ：浏览按钮的文本，默认值：BROWSE 。
buttonImg ：浏览按钮的图片的路径。
hideButton ：设置为true则隐藏浏览按钮的图片。
rollover ：值为true和false，设置为true时当鼠标移到浏览按钮上时有反转效果。
width ：设置浏览按钮的宽度，默认值：110。
height ：设置浏览按钮的高度，默认值：30。
wmode ：设置该项为transparent 可以使浏览按钮的flash背景文件透明，并且flash文件会被置为页面的最高层。默认值：opaque 。
cancelImg ：选择文件到文件队列中后的每一个文件上的关闭按钮图标，如下图：

上面介绍的key值的value都为字符串或是布尔类型，比较简单，接下来要介绍的key值的value为一个函数，可以在选择文件、出错或其他一些操作的时候返回一些信息给用户。

onInit : 做一些初始化的工作。

onSelect ：选择文件时触发，该函数有三个参数

event:事件对象。
queueID：文件的唯一标识，由6为随机字符组成。
fileObj：选择的文件对象，有name、size、creationDate、modificationDate、type 5个属性。
代码如下：

$(document).ready(function()
{
  $("#uploadify").uploadify({
    'uploader': 'JS/jquery.uploadify-v2.1.0/uploadify.swf',
    'script': 'UploadHandler.ashx',
    'cancelImg': 'JS/jquery.uploadify-v2.1.0/cancel.png',
    'folder': 'UploadFile',
    'queueID': 'fileQueue',
    'auto': false,
    'multi': true,
    'onInit':function(){alert("1");},
    'onSelect': function(e, queueId, fileObj)
    {
      alert("唯一标识:" + queueId + "\r\n" +
         "文件名：" + fileObj.name + "\r\n" +
         "文件大小：" + fileObj.size + "\r\n" +
         "创建时间：" + fileObj.creationDate + "\r\n" +
         "最后修改时间：" + fileObj.modificationDate + "\r\n" +
         "文件类型：" + fileObj.type
      );

    }
  });
});

当选择一个文件后弹出的消息如下图：

onSelectOnce ：在单文件或多文件上传时，选择文件时触发。该函数有两个参数event，data，data对象有以下几个属性：

fileCount：选择文件的总数。
filesSelected：同时选择文件的个数，如果一次选择了3个文件该属性值为3。
filesReplaced：如果文件队列中已经存在A和B两个文件，再次选择文件时又选择了A和B，该属性值为2。
allBytesTotal：所有选择的文件的总大小。
onCancel : 当点击文件队列中文件的关闭按钮或点击取消上传时触发。该函数有event、queueId、fileObj、data四个参数，前三个参数同onSelect 中的三个参数，data对象有两个属性fileCount和allBytesTotal。

fileCount：取消一个文件后，文件队列中剩余文件的个数。
allBytesTotal：取消一个文件后，文件队列中剩余文件的大小。
onClearQueue ：当调用函数fileUploadClearQueue时触发。有event和data两个参数，同onCancel 中的两个对应参数。

onQueueFull ：当设置了queueSizeLimit并且选择的文件个数超出了queueSizeLimit的值时触发。该函数有两个参数event和queueSizeLimit。

onError ：当上传过程中发生错误时触发。该函数有event、queueId、fileObj、errorObj四个参数，其中前三个参数同上，errorObj对象有type和info两个属性。

type：错误的类型，有三种‘HTTP', ‘IO', or ‘Security'
info：错误的描述
onOpen ：点击上传时触发，如果auto设置为true则是选择文件时触发，如果有多个文件上传则遍历整个文件队列。该函数有event、queueId、fileObj三个参数，参数的解释同上。

onProgress ：点击上传时触发，如果auto设置为true则是选择文件时触发，如果有多个文件上传则遍历整个文件队列，在onOpen之后触发。该函数有event、queueId、fileObj、data四个参数，前三个参数的解释同上。data对象有四个属性percentage、bytesLoaded、allBytesLoaded、speed：

percentage：当前完成的百分比
bytesLoaded：当前上传的大小
allBytesLoaded：文件队列中已经上传完的大小
speed：上传速率 kb/s
onComplete：文件上传完成后触发。该函数有四个参数event、queueId、fileObj、response、data五个参数，前三个参数同上。response为后台处理程序返回的值，在上面的例子中为1或0，data有两个属性fileCount和speed

fileCount：剩余没有上传完成的文件的个数。
speed：文件上传的平均速率 kb/s
注：fileObj对象和上面讲到的有些不太一样，onComplete 的fileObj对象有个filePath属性可以取出上传文件的路径。

onAllComplete：文件队列中所有的文件上传完成后触发。该函数有event和data两个参数，data有四个属性，分别为：

filesUploaded :上传的所有文件个数。
errors ：出现错误的个数。
allBytesLoaded ：所有上传文件的总大小。
speed ：平均上传速率 kb/s

相关函数介绍

在上面的例子中已经用了uploadifyUpload和uploadifyClearQueue两个函数，除此之外还有几个函数：

uploadifySettings：可以动态修改上面介绍的那些key值，如下面代码

$('#uploadify').uploadifySettings('folder','JS');

如果上传按钮的事件写成下面这样，文件将会上传到uploadifySettings定义的目录中

<a href="javascript:$('#uploadify').uploadifySettings('folder','JS');
$('#uploadify').uploadifyUpload()">上传</a>

uploadifyCancel：该函数接受一个queueID作为参数，可以取消文件队列中指定queueID的文件。

$('#uploadify').uploadifyCancel(id);

花了一个晚上，终于写完了，对JQuery这个上传插件也基本了解了，希望对大家有所帮助，不对之处还望大家指正。

以上所述就是本文的全部内容了，希望大家能够喜欢。

您可能感兴趣的文章:

JQuery学习总结【二】
本文主要介绍了JQuery的基本知识，如：JQuery的dom操作，动态创建dom节点，删除节点，document方法等等，文章篇尾处附上实例小练习。需要的朋友可以参考下
2016-12-12
jQuery实现日历效果
这篇文章主要为大家详细介绍了jQuery实现日历效果，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2020-09-09
宝儿的zQuery库选择器简单原型
编写zQuery库初始起因一则是由于旧版的jQuery执行效率（现在的版本好像还可以），二则是对javascript语言的喜爱，每每总是亲历亲为，最后由于在项目中的需求，加入了对事件侦听机制的和DOM节点操作方法的扩展。
2008-06-06
jQuery插件DataTable使用方法详解(.Net平台)
这篇文章主要为大家详细介绍了jQuery插件DataTable使用方法，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2016-12-12
Jquery为单选框checkbox绑定单击click事件
有些时候可能需要用到脚本为一些窗体绑定事件:比如Jquery为单选框checkbox绑定单击事件,本人搜索整理一些常用技巧，需要了解的朋友可以参考下
2012-12-12
jQuery中has()方法用法实例
这篇文章主要介绍了jQuery中has()方法用法,实例分析了has()方法的功能、定义及保留包含特定后代的匹配元素的使用技巧,需要的朋友可以参考下
2015-01-01
jQuery使用contains过滤器实现精确匹配方法详解
这篇文章主要介绍了jQuery使用contains过滤器实现精确匹配的方法,结合实例形式分析了contains过滤器的具体使用技巧,需要的朋友可以参考下
2016-02-02
jquery 实现的改变颜色与背景的代码 change(fontsize,background)补充2
change事件会在元素失去焦点的时候触发，也会当其值在获得焦点后改变时触发。
2010-05-05
jQuery实现的回车触发按钮事件功能示例
这篇文章主要介绍了jQuery实现的回车触发按钮事件功能,涉及jQuery事件响应及页面元素属性动态操作相关实现技巧,需要的朋友可以参考下
2018-03-03
jQuery实现切换页面过渡动画效果
这是一款效果非常酷的jQuery和CSS3通过AJAX调用切换页面过渡动画特效插件。该页面切换特效使用AJAX来动态加载链接内容，在页面加载的时候，使用CSS3来制作非常酷的页面过渡动画效果。插件中使用pushState方法来管理浏览器的浏览历史，需要的朋友可以参考下
2015-10-10

AspNet中使用JQuery上传插件Uploadify详解

相关文章

最新评论

大家感兴趣的内容

最近更新的内容

常用在线小工具