這篇文章主要介紹了jQuery異步上傳文件插件ajaxFileUpload詳細(xì)介紹,本文首先講解了ajaxFileUpload的參數(shù)、錯(cuò)誤提示等知識(shí),然后給出了簡(jiǎn)單使用實(shí)例和ASP.NET MVC模式下的使用實(shí)例,需要的朋友可以參考下
一、ajaxFileUpload是一個(gè)異步上傳文件的jQuery插件。
傳一個(gè)不知道什么版本的上來(lái),以后不用到處找了。
語(yǔ)法:$.ajaxFileUpload([options])
options參數(shù)說(shuō)明:
1、url 上傳處理程序地址。
2,fileElementId 需要上傳的文件域的ID,即<input type="file">的ID。
3,secureuri 是否啟用安全提交,默認(rèn)為false。
4,dataType 服務(wù)器返回的數(shù)據(jù)類(lèi)型。可以為xml,script,json,html。如果不填寫(xiě),jQuery會(huì)自動(dòng)判斷。
5,success 提交成功后自動(dòng)執(zhí)行的處理函數(shù),參數(shù)data就是服務(wù)器返回的數(shù)據(jù)。
6,error 提交失敗自動(dòng)執(zhí)行的處理函數(shù)。
7,data 自定義參數(shù)。這個(gè)東西比較有用,當(dāng)有數(shù)據(jù)是與上傳的圖片相關(guān)的時(shí)候,這個(gè)東西就要用到了。
8, type 當(dāng)要提交自定義參數(shù)時(shí),這個(gè)參數(shù)要設(shè)置成post
錯(cuò)誤提示:
1,SyntaxError: missing ; before statement錯(cuò)誤
如果出現(xiàn)這個(gè)錯(cuò)誤就需要檢查url路徑是否可以訪問(wèn)
2,SyntaxError: syntax error錯(cuò)誤
如果出現(xiàn)這個(gè)錯(cuò)誤就需要檢查處理提交操作的服務(wù)器后臺(tái)處理程序是否存在語(yǔ)法錯(cuò)誤
3,SyntaxError: invalid property id錯(cuò)誤
如果出現(xiàn)這個(gè)錯(cuò)誤就需要檢查文本域?qū)傩訧D是否存在
4,SyntaxError: missing } in XML expression錯(cuò)誤
如果出現(xiàn)這個(gè)錯(cuò)誤就需要檢查文件name是否一致或不存在
5,其它自定義錯(cuò)誤
大家可使用變量$error直接打印的方法檢查各參數(shù)是否正確,比起上面這些無(wú)效的錯(cuò)誤提示還是方便很多。
使用方法:
第一步:先引入jQuery與ajaxFileUpload插件。注意先后順序,這個(gè)不用說(shuō)了,所有的插件都是這樣。
復(fù)制代碼代碼如下:
<script src="jquery-1.7.1.js" type="text/javascript"></script>
<script src="ajaxfileupload.js" type="text/javascript"></script>
第二步:HTML代碼:
復(fù)制代碼代碼如下:
<body>
<p><input type="file" id="file1" name="file" /></p>
<input type="button" value="上傳" />
<p><img id="img1" style="border-left-color: rgb(0, 153, 204); border-left-width: 1px; border-left-style: solid; padding: 0px 3px; margin: 3px auto 0px; width: 640px; background-color: rgb(242, 246, 251); clear: both; border-top-color: rgb(0, 153, 204); border-top-width: 1px; border-top-style: solid; border-right-color: rgb(0, 153, 204); border-right-width: 1px; border-right-style: solid;"> 復(fù)制代碼代碼如下:
<script src="jquery-1.7.1.js" type="text/javascript"></script>
<script src="ajaxfileupload.js" type="text/javascript"></script>
<script type="text/javascript">
$(function () {
$(":button").click(function () {
ajaxFileUpload();
})
})
function ajaxFileUpload() {
$.ajaxFileUpload
(
{
url: '/upload.aspx', //用于文件上傳的服務(wù)器端請(qǐng)求地址
secureuri: false, //是否需要安全協(xié)議,一般設(shè)置為false
fileElementId: 'file1', //文件上傳域的ID
dataType: 'json', //返回值類(lèi)型 一般設(shè)置為json
success: function (data, status) //服務(wù)器成功響應(yīng)處理函數(shù)
{
$("#img1").attr("src", data.imgurl);
if (typeof (data.error) != 'undefined') {
if (data.error != '') {
alert(data.error);
} else {
alert(data.msg);
}
}
},
error: function (data, status, e)//服務(wù)器響應(yīng)失敗處理函數(shù)
{
alert(e);
}
}
)
return false;
}
</script>
第四步:后臺(tái)頁(yè)面upload.aspx代碼:
復(fù)制代碼代碼如下:
protected void Page_Load(object sender, EventArgs e)
{
HttpFileCollection files = Request.Files;
string msg = string.Empty;
string error = string.Empty;
string imgurl;
if (files.Count > 0)
{
files[0].SaveAs(Server.MapPath("/") + System.IO.Path.GetFileName(files[0].FileName));
msg = " 成功! 文件大小為:" + files[0].ContentLength;
imgurl = "/" + files[0].FileName;
string res = "{ error:'" + error + "', msg:'" + msg + "',imgurl:'" + imgurl + "'}";
Response.Write(res);
Response.End();
}
}
來(lái)一個(gè)MVC版本的實(shí)例:
控制器代碼
復(fù)制代碼代碼如下:
public class HomeController : Controller
{
public ActionResult Index()
{
return View();
}
public ActionResult Upload()
{
HttpFileCollection hfc = System.Web.HttpContext.Current.Request.Files;
string imgPath = "";
if (hfc.Count > 0)
{
imgPath = "/testUpload" + hfc[0].FileName;
string PhysicalPath = Server.MapPath(imgPath);
hfc[0].SaveAs(PhysicalPath);
}
return Content(imgPath);
}
}
前端視圖,HTML與JS代碼,成功上傳后,返回圖片真實(shí)地址并綁定到<img>的SRC地址
復(fù)制代碼代碼如下:
<html>
<head>
<script src="/jquery-1.7.1.js" type="text/javascript"></script>
<script src="/ajaxfileupload.js" type="text/javascript"></script>
<script type="text/javascript">
$(function () {
$(":button").click(function () {
if ($("#file1").val().length > 0) {
ajaxFileUpload();
}
else {
alert("請(qǐng)選擇圖片");
}
})
})
function ajaxFileUpload() {
$.ajaxFileUpload
(
{
url: '/Home/Upload', //用于文件上傳的服務(wù)器端請(qǐng)求地址
secureuri: false, //一般設(shè)置為false
fileElementId: 'file1', //文件上傳空間的id屬性 <input type="file" id="file" name="file" />
dataType: 'HTML', //返回值類(lèi)型 一般設(shè)置為json
success: function (data, status) //服務(wù)器成功響應(yīng)處理函數(shù)
{
alert(data);
$("#img1").attr("src", data);
if (typeof (data.error) != 'undefined') {
if (data.error != '') {
alert(data.error);
} else {
alert(data.msg);
}
}
},
error: function (data, status, e)//服務(wù)器響應(yīng)失敗處理函數(shù)
{
alert(e);
}
}
)
return false;
}
</script>
</head>
<body>
<p><input type="file" id="file1" name="file" /></p>
<input type="button" value="上傳" />
<p><img id="img1" style="border-left-color: rgb(0, 153, 204); border-left-width: 1px; border-left-style: solid; padding: 0px 3px; margin: 3px auto 0px; width: 640px; background-color: rgb(242, 246, 251); clear: both; border-top-color: rgb(0, 153, 204); border-top-width: 1px; border-top-style: solid; border-right-color: rgb(0, 153, 204); border-right-width: 1px; border-right-style: solid;"> 復(fù)制代碼代碼如下:
public class HomeController : Controller
{
public ActionResult Index()
{
return View();
}
public ActionResult Upload()
{
NameValueCollection nvc = System.Web.HttpContext.Current.Request.Form;
HttpFileCollection hfc = System.Web.HttpContext.Current.Request.Files;
string imgPath = "";
if (hfc.Count > 0)
{
imgPath = "/testUpload" + hfc[0].FileName;
string PhysicalPath = Server.MapPath(imgPath);
hfc[0].SaveAs(PhysicalPath);
}
//注意要寫(xiě)好后面的第二第三個(gè)參數(shù)
return Json(new { Id = nvc.Get("Id"), name = nvc.Get("name"), imgPath1 = imgPath },"text/html", JsonRequestBehavior.AllowGet);
}
}
Index視圖代碼:
復(fù)制代碼代碼如下:
<html>
<head>
<script src="/jquery-1.7.1.js" type="text/javascript"></script>
<script src="/ajaxfileupload.js" type="text/javascript"></script>
<script type="text/javascript">
$(function () {
$(":button").click(function () {
if ($("#file1").val().length > 0) {
ajaxFileUpload();
}
else {
alert("請(qǐng)選擇圖片");
}
})
})
function ajaxFileUpload() {
$.ajaxFileUpload
(
{
url: '/Home/Upload', //用于文件上傳的服務(wù)器端請(qǐng)求地址
type: 'post',
data: { Id: '123', name: 'lunis' }, //此參數(shù)非常嚴(yán)謹(jǐn),寫(xiě)錯(cuò)一個(gè)引號(hào)都不行
secureuri: false, //一般設(shè)置為false
fileElementId: 'file1', //文件上傳空間的id屬性 <input type="file" id="file" name="file" />
dataType: 'json', //返回值類(lèi)型 一般設(shè)置為json
success: function (data, status) //服務(wù)器成功響應(yīng)處理函數(shù)
{
alert(data);
$("#img1").attr("src", data.imgPath1);
alert("你請(qǐng)求的Id是" + data.Id + " " + "你請(qǐng)求的名字是:" + data.name);
if (typeof (data.error) != 'undefined') {
if (data.error != '') {
alert(data.error);
} else {
alert(data.msg);
}
}
},
error: function (data, status, e)//服務(wù)器響應(yīng)失敗處理函數(shù)
{
alert(e);
}
}
)
return false;
}
</script>
</head>
<body>
<p><input type="file" id="file1" name="file" /></p>
<input type="button" value="上傳" />
<p><img id="img1" alt="上傳成功啦" src="" /></p>
</body>
</html>
此實(shí)例在顯示出異步上傳圖片的同時(shí)并彈出自定義傳輸?shù)膮?shù)。本實(shí)例
2013年1月28日,今天調(diào)試過(guò)程中發(fā)現(xiàn)一個(gè)問(wèn)題,就是作為文件域(<input type="file">)必須要有name屬性,如果沒(méi)有name屬性,上傳之后服務(wù)器是獲取不到圖片的。如:正確的寫(xiě)法是<input type="file" id="file1" name="file1" />
2013年1月28日,最經(jīng)典的錯(cuò)誤終于找到原因所在了。Object function (a,b){return new e.fn.init(a,b,h)} has no method 'handleError',這個(gè)是google瀏覽器報(bào)的錯(cuò)誤,非常經(jīng)典, 不知道是我的版本問(wèn)題還是真正存在的問(wèn)題。這個(gè)問(wèn)題的根源經(jīng)過(guò)N次上傳才找到問(wèn)題的根本所在。答案是:dataType參數(shù)一定要大寫(xiě)。如:dataType: 'HTML'。