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 进度条显示进度。
<div id=>
<form id=
enctype= method=>
<span =>
<i =></i>
<span>Add files...</span>
<input type=
name= id= />
</span>
<button =
type= id=>
<i =></i>
<span>Start upload</span>
</button>
<button =
type= id=>
<i =></i>
<span>close</span>
</button>
</form>
<div =>
<div id=
= role=
aria-valuenow= aria-valuemin=
aria-valuemax= style=>
<span></span>
</div>
</div>
<div =>
<div id=></div>
<div id= =>
</div>
<div id= =>
</div>
<div id= =>
</div>
</div>
</div>
在Onchange 事件中添加输入文件元素，并在JS方法SingleFileSelected使用，因此在用户选择和修改文件时都会调用此方法。在该方法中，我们将选择输入文件元素和访问FileList的文件对象，选择第一个文件files[0]，因此我们可以得到文件名，文件类型等信息。
function singleFileSelected(evt) {
2: //var selectedFile = evt.target.files can use this or select input file element
3: //and access it's files object
var selectedFile = ($())[0].files[0];
(selectedFile) {
var FileSize = 0;
var imageType = /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)) {
var reader = FileReader();
reader.onload = function (e) {
4:
$().empty();
var dataURL = reader.result;
var img = Image()
img.src = dataURL;
img.className = ;
$().append(img);
};
reader.readAsDataURL(selectedFile);
}
到现在为止，就可看到下图：
现在需要将已上传的文件发送到服务器，因此添加Onclick事件，并在JS uploadFile()方法中调用，代码如下：
function UploadFile() {
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:
var form = $()[0];
var dataString = FormData(form);
$.ajax({
url: ,
type: ,
xhr: function () {
var myXhr = $.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计算出已上传百分之多少的数据。
function progressHandlingFunction(e) {
(e.lengthComputable) {
var percentComplete = 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:
JsonResult Upload(HttpPostedFileBase uploadedFile)
{
(uploadedFile != && uploadedFile.ContentLength > 0)
{
[] FileByteArray = [uploadedFile.ContentLength];
uploadedFile.InputStream.Read(FileByteArray, 0, uploadedFile.ContentLength);
Attachment newAttchment = Attachment();
newAttchment.FileName = uploadedFile.FileName;
newAttchment.FileType = uploadedFile.ContentType;
newAttchment.FileContent = FileByteArray;
OperationResult operationResult = 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,
status = operationResult.Message,
file = uploadedFile.FileName
}, JsonRequestBehavior.AllowGet);
34:
}
}
Json(
{
statusCode = 400,
status = ,
file = .Empty
}, JsonRequestBehavior.AllowGet);
}
能否通过拖拽操作实现多个文件上传的功能？
在这一部分，实现相同的uploader，并为uploader添加一些新功能：
- 允许选择多个文件
- 拖拽操作
现在给Uplodaer View添加新功能：
- 为输入文件元素添加多个属性，实现同时选择多个文件。
- 添加实现拖拽功能的文件，如以下代码所示：
<div id=>Drop images Here</div>
在JS方法MultiplefileSelected中添加onChange事件，与之前SingleFileSelected的写法类似，不同的是需要将所有的文件列出，并允许拖拽文件。代码如下：
function MultiplefileSelected(evt) {
evt.stopPropagation();
evt.preventDefault();
$().removeClass();
selectedFiles = evt.target.files || evt.dataTransfer.files;
(selectedFiles) {
$().empty();
(var i = 0; i < selectedFiles.length; i++) {
DataURLFileReader.read(selectedFiles[i], function (err, fileInfo) {
(err != ) {
var RowInfo = + i +
class="info"><div class="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);
}
{
var image = + fileInfo.fileContent +
+
fileInfo.name + ;
var RowInfo = + i +
class="info"><div class="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对象包括了所有的文件信息及内容。
var DataURLFileReader = {
read: function (file, callback) {
var reader = FileReader();
var fileInfo = {
name: file.name,
type: file.type,
fileContent: ,
size: function () {
var FileSize = 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事件。
var dropZone = document.getElementById();
dropZone.addEventListener(, handleDragOver, );
dropZone.addEventListener(, MultiplefileSelected, );
dropZone.addEventListener(, dragenterHandler, );
dropZone.addEventListener(, dragleaveHandler, );
当文件拖到目标位置时触发dragover事件，在以下代码中，我们修改了默认浏览器及datatransfer的dropEffect 属性，代码如下：
function handleDragOver(evt) {
evt.preventDefault();
evt.dataTransfer.effectAllowed = ;
evt.dataTransfer.dropEffect = ;
}
接着在MultiplefileSelected中添加drop事件来处理文件drop操作。
大部分功能已经完善，现在需要添加“上传按钮”，通过Onclick事件来调用UploadMultipleFiles方法。
该方法与上文提到的Uploadfile方法类似，不同的是手动验证formdata对象值。
function UploadMultipleFiles() {
2:
3: // here we will create FormData manually to prevent sending mon image files
var dataString = FormData();
5: //var files = document.getElementById("UploadedFiles").files;
(var i = 0; i < selectedFiles.length; i++) {
(!selectedFiles[i].type.match()) {
;
}
}
11: // AJAX Request code here
}
接下来添加服务器端处理代码，与上文添加的代码类似，需要做的就是接受一系列的文件列表，如下：
JsonResult UplodMultiple(HttpPostedFileBase[] uploadedFiles)
确保 HttpPostedFileBase 数组名称与append 方法中的名称相同，只有这样，MVC才能映射到文件数组中。
JsonResult UplodMultiple(HttpPostedFileBase[] uploadedFiles)
dataString.append(, selectedFiles[i]);
上传大文件
为了允许上传大文件，如果使用的是 IIS7及以上版本，需要修改Web.config 文件，添加以下代码：
<system.webServer>
<security>
<requestFiltering>
<requestLimits maxAllowedContentLength= />
</requestFiltering>
</security>
</system.webServer>
8:
<httpRuntime targetFramework= maxRequestLength=/>
到这里所有的功能就可以实现了，而且最大可上传2GB的文件。