该示例中实际上应用了 jquery ajax(web client) + async web api 双异步。
jquery ajax post
$.ajax({
type: "POST",
url: "/api/FileUpload",
contentType: false,
processData: false,
data: data,
success: function (results) {
ShowUploadControls();
$("#uploadResults").empty();
for (i = 0; i < results.length; i++) {
$("#uploadResults").append($("<li/>").text(results[i]));
}
},
error: function (xhr, ajaxOptions, thrownError) {
ShowUploadControls();
alert(xhr.responseText);
}
});
client端以post的方式发送数据。其中上传成功后的回调脚本定义在success处。
async Web API
Controller处Action返回值为Task<TResult>，本例中如下定义：
public Task<IEnumerable<string>> Post()
{
... ...
}
而具体异步效果体现在“文件内容读取”和“后续处理”上。
string fullPath = HttpContext.Current.Server.MapPath("~/Uploads");
CustomMultipartFormDataStreamProvider streamProvider = new CustomMultipartFormDataStreamProvider(fullPath);
var task = Request.Content.ReadAsMultipartAsync(streamProvider).ContinueWith(t =>
{
if (t.IsFaulted || t.IsCanceled)
throw new HttpResponseException(HttpStatusCode.InternalServerError);
var fileInfo = streamProvider.FileData.Select(i =>
{
var info = new FileInfo(i.LocalFileName);
return "File saved as " + info.FullName + " (" + info.Length + ")";
});
return fileInfo;
});
ReadAsMultipartAsync
(From MSDN) 读取 MIME 多部分消息中的所有正文部分，并通过使用 streamProvider 实例确定每个正文部分内容的写入位置，来生成一组 HttpContent 实例作为结果。
Task.ContinueWith<TResult>
创建一个在目标 Task 完成时异步执行的延续任务。具体到该示例中，当 ReadAsMultipartAsync(读取)任务完成后，ContinueWith 中定义的行为才会作为延续而异步执行。
MultipartFormDataStreamProvider 对象
一个 IMultipartStreamProvider，适合与 HTML 文件上载一起使用，以将文件内容写入 FileStream。流提供程序将查看 <b>Content-Disposition</b> 标头字段，并根据 <b>filename</b> 参数是否存在来确定输出 Stream。如果 <b>Content-Disposition</b> 标头字段中存在 <b>filename</b> 参数，则正文部分将写入 FileStream 中；否则，正文部分将写入 MemoryStream 中。这将更加便于处理作为窗体数据和文件内容的组合的 MIME 多部分 HTML 窗体数据。
小技巧：lambda 表达式反转，从FileData到IEnumerable<string>
var fileInfo = streamProvider.FileData.Select(i =>
{
var info = new FileInfo(i.LocalFileName);
return "File saved as " + info.FullName + " (" + info.Length + ")";
});