原文地址：http://www.cnblogs.com/Lewis/archive/2010/04/27/1722024.html
關(guān)于JQuery上傳插件Uploadify使用詳解網(wǎng)上一大把，基本上內(nèi)容都一樣。我根據(jù)網(wǎng)上的步驟配置成功后，會(huì)報(bào)一些錯(cuò)誤，而我根據(jù)這些錯(cuò)誤去網(wǎng)上找解決方案，卻沒(méi)有相關(guān)資料，所以為了不讓更多的朋友走彎路，我把我遇到的一些問(wèn)題進(jìn)行匯總，也方便我自己以后查閱。
什么是Uploadify
Uploadify是JQuery的一個(gè)上傳插件，支持多文件上傳，實(shí)現(xiàn)的效果非常不錯(cuò)，帶進(jìn)度顯示。
官網(wǎng)提供的是PHP的DEMO,在這里我詳細(xì)介紹在Asp.net下的使用.
下載
官方下載
官方文檔
官方演示
如何使用
1 創(chuàng)建Web項(xiàng)目，命名為JQueryUploadDemo，從官網(wǎng)上下載最新的版本解壓后添加到項(xiàng)目中
2 在項(xiàng)目中添加UploadHandler.ashx文件用來(lái)處理文件的上傳。
3 在項(xiàng)目中添加UploadFile文件夾，用來(lái)存放上傳的文件。
進(jìn)行完上面三步后項(xiàng)目的基本結(jié)構(gòu)如下圖:
4 Default.aspx的html頁(yè)的代碼修改如下：
<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);
//下面這句代碼缺少的話，上傳成功后上傳隊(duì)列的顯示不會(huì)自動(dòng)消失
context.Response.Write("1");
}
else
{
context.Response.Write("0");
}
}
注意:這里一定要注意，一定要引用using System.IO;命名空間，我出錯(cuò)的原因也是在這里，網(wǎng)上的教程基本上都沒(méi)提到這一點(diǎn)，所以有很多網(wǎng)友會(huì)遇到IOError的錯(cuò)誤。
6 運(yùn)行后效果如下圖：
7 選擇了兩個(gè)文件后，點(diǎn)擊上傳，就可以看到UploadFile文件夾中會(huì)增加這兩個(gè)文件。
上面的代碼就簡(jiǎn)單實(shí)現(xiàn)了上傳的功能，依靠函數(shù)uploadify實(shí)現(xiàn)，uploadify函數(shù)的參數(shù)為json格式，可以對(duì)json對(duì)象的key值的修改來(lái)進(jìn)行自定義的設(shè)置，如multi設(shè)置為true或false來(lái)控制是否可以進(jìn)行多文件上傳，下面就來(lái)介紹下這些key值的意思：
uploader ： uploadify.swf 文件的相對(duì)路徑，該swf文件是一個(gè)帶有文字BROWSE的按鈕，點(diǎn)擊后淡出打開(kāi)文件對(duì)話框，默認(rèn)值：uploadify.swf。
script ： 后臺(tái)處理程序的相對(duì)路徑 。默認(rèn)值：uploadify.php
checkScript ：用來(lái)判斷上傳選擇的文件在服務(wù)器是否存在的后臺(tái)處理程序的相對(duì)路徑
fileDataName ：設(shè)置一個(gè)名字，在服務(wù)器處理程序中根據(jù)該名字來(lái)取上傳文件的數(shù)據(jù)。默認(rèn)為Filedata
method ： 提交方式Post 或Get 默認(rèn)為Post
scriptAccess ：flash腳本文件的訪問(wèn)模式，如果在本地測(cè)試設(shè)置為always，默認(rèn)值：sameDomain
folder ： 上傳文件存放的目錄 。
queueID ： 文件隊(duì)列的ID，該ID與存放文件隊(duì)列的div的ID一致。
queueSizeLimit ： 當(dāng)允許多文件生成時(shí)，設(shè)置選擇文件的個(gè)數(shù)，默認(rèn)值：999 。
multi ： 設(shè)置為true時(shí)可以上傳多個(gè)文件。
auto ： 設(shè)置為true當(dāng)選擇文件后就直接上傳了，為false需要點(diǎn)擊上傳按鈕才上傳 。
fileDesc ： 這個(gè)屬性值必須設(shè)置fileExt屬性后才有效，用來(lái)設(shè)置選擇文件對(duì)話框中的提示文本，如設(shè)置fileDesc為“請(qǐng)選擇rar doc pdf文件”，打開(kāi)文件選擇框效果如下圖：
fileExt ： 設(shè)置可以選擇的文件的類型，格式如：'*.doc;*.pdf;*.rar' 。
sizeLimit ： 上傳文件的大小限制 。
simUploadLimit ： 允許同時(shí)上傳的個(gè)數(shù) 默認(rèn)值：1 。
buttonText ： 瀏覽按鈕的文本，默認(rèn)值：BROWSE 。
buttonImg ： 瀏覽按鈕的圖片的路徑 。
hideButton ： 設(shè)置為true則隱藏瀏覽按鈕的圖片 。
rollover ： 值為true和false，設(shè)置為true時(shí)當(dāng)鼠標(biāo)移到瀏覽按鈕上時(shí)有反轉(zhuǎn)效果。
width ： 設(shè)置瀏覽按鈕的寬度 ，默認(rèn)值：110。
height ： 設(shè)置瀏覽按鈕的高度 ，默認(rèn)值：30。
wmode ： 設(shè)置該項(xiàng)為transparent 可以使瀏覽按鈕的flash背景文件透明，并且flash文件會(huì)被置為頁(yè)面的最高層。 默認(rèn)值：opaque 。
cancelImg ：選擇文件到文件隊(duì)列中后的每一個(gè)文件上的關(guān)閉按鈕圖標(biāo)，如下圖：
上面介紹的key值的value都為字符串或是布爾類型，比較簡(jiǎn)單，接下來(lái)要介紹的key值的value為一個(gè)函數(shù)，可以在選擇文件、出錯(cuò)或其他一些操作的時(shí)候返回一些信息給用戶。
onInit : 做一些初始化的工作。
onSelect ：選擇文件時(shí)觸發(fā)，該函數(shù)有三個(gè)參數(shù)
- event:事件對(duì)象。
- queueID：文件的唯一標(biāo)識(shí)，由6為隨機(jī)字符組成。
- fileObj：選擇的文件對(duì)象，有name、size、creationDate、modificationDate、type 5個(gè)屬性。
代碼如下：
$(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("唯一標(biāo)識(shí):" + queueId + "\r\n" +
"文件名：" + fileObj.name + "\r\n" +
"文件大小：" + fileObj.size + "\r\n" +
"創(chuàng)建時(shí)間：" + fileObj.creationDate + "\r\n" +
"最后修改時(shí)間：" + fileObj.modificationDate + "\r\n" +
"文件類型：" + fileObj.type
);
}
});
});
當(dāng)選擇一個(gè)文件后彈出的消息如下圖：
onSelectOnce ：在單文件或多文件上傳時(shí)，選擇文件時(shí)觸發(fā)。該函數(shù)有兩個(gè)參數(shù)event，data，data對(duì)象有以下幾個(gè)屬性：
fileCount：選擇文件的總數(shù)。
filesSelected：同時(shí)選擇文件的個(gè)數(shù)，如果一次選擇了3個(gè)文件該屬性值為3。
filesReplaced：如果文件隊(duì)列中已經(jīng)存在A和B兩個(gè)文件，再次選擇文件時(shí)又選擇了A和B，該屬性值為2。
allBytesTotal：所有選擇的文件的總大小。
onCancel : 當(dāng)點(diǎn)擊文件隊(duì)列中文件的關(guān)閉按鈕或點(diǎn)擊取消上傳時(shí)觸發(fā)。該函數(shù)有event、queueId、fileObj、data四個(gè)參數(shù)，前三個(gè)參數(shù)同onSelect 中的三個(gè)參數(shù)，data對(duì)象有兩個(gè)屬性fileCount和allBytesTotal。
fileCount：取消一個(gè)文件后，文件隊(duì)列中剩余文件的個(gè)數(shù)。
allBytesTotal：取消一個(gè)文件后，文件隊(duì)列中剩余文件的大小。
onClearQueue ：當(dāng)調(diào)用函數(shù)fileUploadClearQueue時(shí)觸發(fā)。有event和data兩個(gè)參數(shù)，同onCancel 中的兩個(gè)對(duì)應(yīng)參數(shù)。
onQueueFull ：當(dāng)設(shè)置了queueSizeLimit并且選擇的文件個(gè)數(shù)超出了queueSizeLimit的值時(shí)觸發(fā)。該函數(shù)有兩個(gè)參數(shù)event和queueSizeLimit。
onError ：當(dāng)上傳過(guò)程中發(fā)生錯(cuò)誤時(shí)觸發(fā)。該函數(shù)有event、queueId、fileObj、errorObj四個(gè)參數(shù)，其中前三個(gè)參數(shù)同上，errorObj對(duì)象有type和info兩個(gè)屬性。
type：錯(cuò)誤的類型，有三種‘HTTP’, ‘IO’, or ‘Security’
info：錯(cuò)誤的描述
onOpen ：點(diǎn)擊上傳時(shí)觸發(fā)，如果auto設(shè)置為true則是選擇文件時(shí)觸發(fā)，如果有多個(gè)文件上傳則遍歷整個(gè)文件隊(duì)列。該函數(shù)有event、queueId、fileObj三個(gè)參數(shù)，參數(shù)的解釋同上。
onProgress ：點(diǎn)擊上傳時(shí)觸發(fā)，如果auto設(shè)置為true則是選擇文件時(shí)觸發(fā)，如果有多個(gè)文件上傳則遍歷整個(gè)文件隊(duì)列，在onOpen之后觸發(fā)。該函數(shù)有event、queueId、fileObj、data四個(gè)參數(shù)，前三個(gè)參數(shù)的解釋同上。data對(duì)象有四個(gè)屬性percentage、bytesLoaded、allBytesLoaded、speed：
percentage：當(dāng)前完成的百分比
bytesLoaded：當(dāng)前上傳的大小
allBytesLoaded：文件隊(duì)列中已經(jīng)上傳完的大小
speed：上傳速率 kb/s
onComplete：文件上傳完成后觸發(fā)。該函數(shù)有四個(gè)參數(shù)event、queueId、fileObj、response、data五個(gè)參數(shù)，前三個(gè)參數(shù)同上。response為后臺(tái)處理程序返回的值，在上面的例子中為1或0，data有兩個(gè)屬性fileCount和speed
fileCount：剩余沒(méi)有上傳完成的文件的個(gè)數(shù)。
speed：文件上傳的平均速率 kb/s
注：fileObj對(duì)象和上面講到的有些不太一樣，onComplete 的fileObj對(duì)象有個(gè)filePath屬性可以取出上傳文件的路徑。
onAllComplete：文件隊(duì)列中所有的文件上傳完成后觸發(fā)。該函數(shù)有event和data兩個(gè)參數(shù)，data有四個(gè)屬性，分別為：
filesUploaded :上傳的所有文件個(gè)數(shù)。
errors ：出現(xiàn)錯(cuò)誤的個(gè)數(shù)。
allBytesLoaded ：所有上傳文件的總大小。
speed ：平均上傳速率 kb/s
相關(guān)函數(shù)介紹
在上面的例子中已經(jīng)用了uploadifyUpload和uploadifyClearQueue兩個(gè)函數(shù)，除此之外還有幾個(gè)函數(shù)：
uploadifySettings：可以動(dòng)態(tài)修改上面介紹的那些key值，如下面代碼
$('#uploadify').uploadifySettings('folder','JS');
如果上傳按鈕的事件寫(xiě)成下面這樣，文件將會(huì)上傳到uploadifySettings定義的目錄中
<a href="javascript:$('#uploadify').uploadifySettings('folder','JS');$('#uploadify').uploadifyUpload()">上傳</a>
uploadifyCancel：該函數(shù)接受一個(gè)queueID作為參數(shù)，可以取消文件隊(duì)列中指定queueID的文件。
$('#uploadify').uploadifyCancel(id);
好了，所有的配置都完成了。下面說(shuō)說(shuō)我遇到的一些問(wèn)題。 span style="font-size: 18pt;"> 可能遇到的問(wèn)題 1.我剛開(kāi)始配置完成后，并不能正常工作 ，flash（uploadify.swf' ）沒(méi)有加載。后來(lái)我查看jquery.uploadify.v2.1.0.js發(fā)現(xiàn)該插件是利用swfobject.js動(dòng)態(tài)創(chuàng)建的FLASH，后來(lái)我單獨(dú)做試驗(yàn)還是不能顯示flash，無(wú)耐之下重啟電腦后就可以了。暈倒～～～ 2.FLASH終于加載進(jìn)來(lái)了，但上傳又失敗了。報(bào)IOError,如圖：
百思不得其解，翻遍了各大網(wǎng)絡(luò)，終于在國(guó)外的一網(wǎng)站看到了這么一句using System.IO; 添加之豁然開(kāi)朗！！
暫時(shí)還沒(méi)有遇到其它問(wèn)題，后續(xù)發(fā)現(xiàn)問(wèn)題再加。