MVC5:使用Ajax和HTML5实现文件上传功能

前端之家收集整理的这篇文章主要介绍了MVC5:使用Ajax和HTML5实现文件上传功能前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

引言

在实际编程中,经常遇到实现文件上传显示上传进度的功能,基于此目的,本文就为大家介绍不使用flash 或任何上传文件插件来实现带有进度显示文件上传功能

基本功能:实现带有进度条的文件上传功能

高级功能:通过拖拽文件的操作实现多个文件上传功能

背景

HTML5提供了一种标准的访问本地文件方法——File API规格说明,通过调用File API 能够访问文件信息,也可以利用客户端来验证上传文件的类型和大小是否规范。

该规格说明包含以下几个接口来使用文件

File接口:具有文件的“读权限”,可以获取文件名,类型,大小等。

FileList接口:指单独选定的文件列表,可以通过<input type="file">或拖拽呈现在用户界面供用户选择。

XMLHTTPRequest2是HTML5的无名英雄,XHR2与XMLHttpRequest大体相同,但同时也添加了很多新功能,如下:

1. 增加上传/下载二进制数据

2. 增加上传过程中Progess (进度条)事件,该事件包含多部分的信息:

  • Total:整型值,用于指定传输数据的总字节数。
  • Loaded:整型值,用于指定上传的字节。
  • lengthComputable:Bool值用于检测上传文件大小是否可计算。

3. 跨资源共享请求

这些新特性都使得Ajax和HTML5很好的协作,让文件上传变得非常简单,不再需要使用Flash Player、外部插件或html的<form>标签就可以完成,根据服务器端就可以显示上传进度条。

本文会编写一个小型应用程序,能够实现以下功能

首先我们需要检验浏览器是否支持XHR2,File API,FormData及拖拽操作。

编写代码

如何上传单个文件显示上传进度?

首先需要做的是创建简单的View :

  • 定义一个表单,由输入文件元素和提交按钮组成。
  • 使用Bootstrap 进度条显示进度。
<divid=

在Onchange 事件中添加输入文件元素,并在JS方法SingleFileSelected使用,因此在用户选择和修改文件时都会调用方法。在该方法中,我们将选择输入文件元素和访问FileList的文件对象,选择第一个文件files[0],因此我们可以得到文件名,文件类型等信息。

functionsingleFileSelected(evt){
  2:     //var selectedFile = evt.target.files can use this or select input file element 
  3:     //and access it's files object
varselectedFile=($())[0].files[0];
(selectedFile){
varFileSize=0;
varimageType=/image.*/;
(selectedFile.size>1048576){
FileSize=Math.round(selectedFile.size*100/1048576)/100+;
}
(selectedFile.size>1024){
FileSize=Math.round(selectedFile.size*100/1024)/100+;
}
{
FileSize=selectedFile.size+;
}
 17:         // here we will add the code of thumbnail preview of upload images
 18: 
$().text(+selectedFile.name);
$().text(+selectedFile.type);
$().text(+FileSize);
}
}

可以通过File reader对象从内存读取上传文件内容。reader 对象提供很多事件,onload,onError以及四种读取数据的函数readAsBinaryString(),readAsText(),readAsArrayBuffer(), readAsDataURL(),result属性表示文件内容。该属性只有当读操作执行完成后才有效,数据格式根据调用的初始化读操作制定的。

在这里就不详细解释File reader,我们会在SingleFileSelected 方法中使用,用于预览图像,查看代码

(selectedFile.type.match(imageType)){
varreader=FileReader();
reader.onload=function(e){
  4: 
$().empty();
vardataURL=reader.result;
varimg=Image()
img.src=dataURL;
img.className=;
$().append(img);
};
reader.readAsDataURL(selectedFile);
}


到现在为止,就可看到下图:

现在需要将已上传文件发送到服务器,因此添加Onclick事件,并在JS uploadFile()方法调用代码如下:

functionUploadFile(){
  2:     //we can create form by passing the form to Constructor of formData object
  3:     //or creating it manually using append function 
  4:     //but please note file name should be same like the action Parameter
  5:     //var dataString = new FormData();
  6:     //dataString.append("UploadedFile",selectedFile);
  7: 
varform=$()[0];
vardataString=FormData(form);
$.ajax({
url:,
type:,
xhr:function(){
varmyXhr=$.ajaxSettings.xhr();
(myXhr.upload){
 16:                 //myXhr.upload.onprogress = progressHandlingFunction
myXhr.upload.addEventListener(,progressHandlingFunction,
);
}
myXhr;
},
 22:         //Ajax events
success:successHandler,
error:errorHandler,
complete:completeHandler,
 26:         // Form data
data:dataString,
 28:         //Options to tell jQuery not to process data or worry about content-type.
cache:,
contentType:,
processData:
});
}

在该方法中,发送表单,使用Form 数据对象来序列化文件值,我们可以手动创建formdata数据的实例化,通过调用append()方法将域值挂起,或是通过检索HTML 表单的FormData对象。

progressHandlingFunction方法会提供检验上传文件Size 是否可计算,使用e.loaded和e.total计算出已上传百分之多少的数据。

functionprogressHandlingFunction(e){
(e.lengthComputable){
varpercentComplete=Math.round(e.loaded*100/e.total);
$().css(,
percentComplete+).attr(,percentComplete);
$().text(percentComplete+);
}
{
$().text();
}
}

现在已经实现了基本的发送数据及提供进度条的功能,接下来需要实现服务器端的代码处理,使用upload action方法和uplpader controller 。

在upload 方法中,可以从HttpPostedfileBase对象中获取文件信息,该对象包含上传文件的基本信息如Filename属性,Contenttype属性,inputStream属性内容,这些信息都可以用来验证服务器端接收的文件是否有错,也可以用来保存文件

[HttpPost]
  2: 
JsonResultUpload(HttpPostedFileBaseuploadedFile)
{
(uploadedFile!=&&uploadedFile.ContentLength>0)
{
[]FileByteArray=[uploadedFile.ContentLength];
uploadedFile.InputStream.Read(FileByteArray,uploadedFile.ContentLength);
AttachmentnewAttchment=Attachment();
newAttchment.FileName=uploadedFile.FileName;
newAttchment.FileType=uploadedFile.ContentType;
newAttchment.FileContent=FileByteArray;
OperationResultoperationResult=attachmentManager.SaveAttachment(newAttchment);
(operationResult.Success)
{
HTMLString=CaptureHelper.RenderViewToString
(,newAttchment,.ControllerContext);
Json(
{
statusCode=200,
status=operationResult.Message,
NewRow=HTMLString
},JsonRequestBehavior.AllowGet);
 24: 
}
 26:                 else
{
Json(
{
statusCode=400,
file=uploadedFile.FileName
},JsonRequestBehavior.AllowGet);
 34: 
}
}
Json(
{
statusCode=400,
status=,
file=.Empty
},JsonRequestBehavior.AllowGet);
}

能否通过拖拽操作实现多个文件上传功能

在这一部分,实现相同的uploader,并为uploader添加一些新功能

  • 允许选择多个文件
  • 拖拽操作

现在给Uplodaer View添加功能

<divid=>DropimagesHere</div>

在JS方法MultiplefileSelected中添加onChange事件,与之前SingleFileSelected的写法类似,不同的是需要将所有的文件列出,并允许拖拽文件代码如下:

functionMultiplefileSelected(evt){
evt.stopPropagation();
evt.preventDefault();
$().removeClass();
selectedFiles=evt.target.files||evt.dataTransfer.files;
(selectedFiles){
$().empty();
(vari=0;i<selectedFiles.length;i++){
DataURLFileReader.read(selectedFiles[i],function(err,fileInfo){
(err!=){
varRowInfo=+i+
class="info"><divclass="InfoContainer">'+
+err++
 14:                                   '<div data-name="FileName" 
class="info">'+fileInfo.name++
 16:                                   '<div data-type="FileType" 
class="info">'+fileInfo.type++
 18:                                   '<div data-size="FileSize" 
class="info">'+fileInfo.size()+
;
$().append(RowInfo);
}
{
varimage=+fileInfo.fileContent+
+
fileInfo.name+;
varRowInfo=+i+
class="info"><divclass="InfoContainer">'+
+
image++
 31:                                   '<div data-name="FileName" 
class="info">'+fileInfo.name++
 33:                                   '<div data-type="FileType" 
class="info">'+fileInfo.type++
 35:                                   '<div data-size="FileSize" 
class="info">'+fileInfo.size()+
;
$().append(RowInfo);
}
});
}
}
}

在该方法中,将选择和拖拽文件操作的变量设置为全局变量selectedFiles,然后扫描 selectedfiles中的每个文件,将从 DataURLreader对象中调用Read 方法读取文件

DataURLreader对象可调用read方法,并将File对象和回调方法作为read方法参数,在上述方法中我们创建了FileReader,并修改了FileReader的Onload和onerror回调函数调用 readAsDataURL 方法来读文件

新建FileInfo对象包括了所有的文件信息及内容

varDataURLFileReader={
read:function(file,callback){
varreader=FileReader();
varfileInfo={
name:file.name,
type:file.type,
fileContent:,
size:function(){
varFileSize=0;
(file.size>1048576){
FileSize=Math.round(file.size*100/1048576)/100+;
}
(file.size>1024){
FileSize=Math.round(file.size*100/1024)/100+;
}
{
FileSize=file.size+;
}
FileSize;
}
};
(!file.type.match()){
callback(,fileInfo);
;
}
reader.onload=function(){
fileInfo.fileContent=reader.result;
callback(,fileInfo);
};
reader.onerror=function(){
callback(reader.error,fileInfo);
};
reader.readAsDataURL(file);
}
};

使用拖拽操作选择

由于大部分浏览器现在已经执行拖拽操作,为了实现拖拽操作,在drop_zone 元素中添加dragover和drop事件。

vardropZone=document.getElementById();
dropZone.addEventListener(,handleDragOver,);
dropZone.addEventListener(,MultiplefileSelected,);
dropZone.addEventListener(,dragenterHandler,dragleaveHandler,);

文件拖到目标位置时触发dragover事件,在以下代码中,我们修改了默认浏览器及datatransfer的dropEffect 属性代码如下:

functionhandleDragOver(evt){
evt.preventDefault();
evt.dataTransfer.effectAllowed=;
evt.dataTransfer.dropEffect=;
}

接着在MultiplefileSelected中添加drop事件来处理文件drop操作。

大部分功能已经完善,现在需要添加上传按钮”,通过Onclick事件来调用UploadMultipleFiles方法

方法与上文提到的Uploadfile方法类似,不同的是手动验证formdata对象值。

functionUploadMultipleFiles(){
  2: 
  3:     // here we will create FormData manually to prevent sending mon image files
vardataString=FormData();
  5:     //var files = document.getElementById("UploadedFiles").files;
(vari=0;i<selectedFiles.length;i++){
(!selectedFiles[i].type.match()){
;
}
}
 11: // AJAX Request code here
}

接下来添加服务器端处理代码,与上文添加代码类似,需要做的就是接受一系列的文件列表,如下:

JsonResultUplodMultiple(HttpPostedFileBase[]uploadedFiles)

确保 HttpPostedFileBase 数组名称与append 方法中的名称相同,只有这样,MVC才能映射到文件数组中。

JsonResultUplodMultiple(HttpPostedFileBase[]uploadedFiles)
dataString.append(,selectedFiles[i]);

上传文件

为了允许上传文件,如果使用的是 IIS7及以上版本,需要修改Web.config 文件添加以下代码

<system.webServer>
<security>
<requestFiltering>
<requestLimitsmaxAllowedContentLength=/>
</requestFiltering>
</security>
</system.webServer>
  8: 
<httpRuntiMetargetFramework=maxRequestLength=/>

到这里所有的功能就可以实现了,而且最大可上传2GB的文件

猜你在找的Ajax相关文章