MVC5:使用Ajax和HTML5实现文件上传功能
引言在实际编程中,经常遇到实现文件上传并显示上传进度的功能,基于此目的,本文就为大家介绍不使用flash 或任何上传文件的插件来实现带有进度显示的文件上传功能。 基本功能:实现带有进度条的文件上传功能 高级功能:通过拖拽文件的操作实现多个文件上传功能 背景HTML5提供了一种标准的访问本地文件的方法——File API规格说明,通过调用File API 能够访问文件信息,也可以利用客户端来验证上传文件的类型和大小是否规范。 该规格说明包含以下几个接口来使用文件: File接口:具有文件的“读权限”,可以获取文件名,类型,大小等。 FileList接口:指单独选定的文件列表,可以通过<input type="file">或拖拽呈现在用户界面供用户选择。 XMLHTTPRequest2是HTML5的无名英雄,XHR2与XMLHttpRequest大体相同,但同时也添加了很多新功能,如下: 1. 增加了上传/下载二进制数据 2. 增加了上传过程中Progess (进度条)事件,该事件包含多部分的信息:
3. 跨资源共享请求 这些新特性都使得Ajax和HTML5很好的协作,让文件上传变得非常简单,不再需要使用Flash Player、外部插件或html的<form>标签就可以完成,根据服务器端就可以显示上传进度条。 本文会编写一个小型应用程序,能够实现以下功能:
首先我们需要检验浏览器是否支持XHR2,File API,FormData及拖拽操作。 编写代码如何上传单个文件并显示上传进度?首先需要做的是创建简单的View :
<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以及四种读取数据的函数 在这里就不详细解释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 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回调函数。调用
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事件,在以下代码中,我们修改了默认浏览器及 functionhandleDragOver(evt){ evt.preventDefault(); evt.dataTransfer.effectAllowed=; evt.dataTransfer.dropEffect=; } 接着在MultiplefileSelected中添加drop事件来处理文件drop操作。 大部分功能已经完善,现在需要添加“上传按钮”,通过Onclick事件来调用UploadMultipleFiles方法。 该方法与上文提到的 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的文件。 (编辑:李大同) 【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容! |