ASP.NET Core文件上传与下载(多种上传方式)
前段时间项目上线,实在太忙,最近终于开始可以研究研究ASP.NET Core了.
打算写个系列,但是还没想好目录,今天先来一篇,后面在整理吧.
ASP.NET Core 2.0 发展到现在,已经很成熟了.下个项目争取使用吧.
1.使用模型绑定上传文件(官方例子)
官方机器翻译的地址:https://docs.microsoft.com/en-us/aspnet/core/mvc/models/file-uploads
这里吐槽一下 - -,这TM的机器翻译..还不如自己看E文的..
首先我们需要创建一个form表单如下:
<form method="post" enctype="multipart/form-data" asp-controller="UpLoadFile" asp-action="FileSave"> <div> <div> <p>Form表单多个上传文件:</p> <input type="file" name="files" multiple /> <input type="submit" value="上传" /> </div> </div> </form>
其中,asp-controller和asp-action,(这个是TagHelper的玩法,以后讲)是我们要访问的控制器和方法.
给我们的input标签加上 multiple 属性,来支持多文件上传.
创建一个控制器,我们编写上传方法如下:
public async Task<IActionResult> FileSave(List<IFormFile> files) { var files = Request.Form.Files; long size = files.Sum(f => f.Length); string webRootPath = _hostingEnvironment.WebRootPath; string contentRootPath = _hostingEnvironment.ContentRootPath; foreach (var formFile in files) { if (formFile.Length > 0) { string fileExt = GetFileExt(formFile.FileName); //文件扩展名，不含“.” long fileSize = formFile.Length; //获得文件大小，以字节为单位 string newFileName = System.Guid.NewGuid().ToString() + "." + fileExt; //随机生成新的文件名 var filePath = webRootPath +"/upload/" + newFileName; using (var stream = new FileStream(filePath, FileMode.Create)) { await formFile.CopyToAsync(stream); } } } return Ok(new { count = files.Count, size }); }
这里我们采用Asp.NET Core的新接口IFormFile, IFormFile的具体定义如下:
public interface IFormFile { string ContentType { get; } string ContentDisposition { get; } IHeaderDictionary Headers { get; } long Length { get; } string Name { get; } string FileName { get; } Stream OpenReadStream(); void CopyTo(Stream target); Task CopyToAsync(Stream target, CancellationToken cancellationToken = null); }
上面的代码使用了IHostingEnvironment来获取项目的根目录地址.
构造函数注入的代码如下:
private readonly IHostingEnvironment _hostingEnvironment; public UpLoadFileController(IHostingEnvironment hostingEnvironment) { _hostingEnvironment = hostingEnvironment; }
这样,我们就完成了控制器的编写,然后到运行前端,上传文件..效果如下:
通过IFormFile的CopyToAsync方法,我们就可以把这个文件流复制下来并保存到本地即可.
2.使用Ajax上传文件
上面我们是使用表单上传,但是项目过程中,大部分情况会使用Ajax进行上传,所以我们就来讲讲如何使用Ajax上传.
首先编写HTML代码如下:
<div> <form id="uploadForm"> AJAX上传多文件： <input type="file" name="file" multiple /> <input type="button" value="上传" onclick="doUpload()" /> </form> </div>
编写JS代码如下(这里我们使用FormData对象来上传):
function doUpload() { var formData = new FormData($("#uploadForm")[0]); $.ajax({ url: '@Url.Action("FileSave")', type: 'POST', data: formData, async: false, cache: false, contentType: false, processData: false, success: function (returndata) { alert(returndata); }, error: function (returndata) { alert(returndata); } }); }
后台代码不做任何修改.我们会发现.直接在List<IFormFile> files中是无法获取到文件的.
通过调试,我们可以发现,文件是上传成功的,但是放在了Request.Form.Files当中.
所以修改后台代码如下:
public async Task<IActionResult> FileSave() { var date = Request; var files = Request.Form.Files; long size = files.Sum(f => f.Length); string webRootPath = _hostingEnvironment.WebRootPath; string contentRootPath = _hostingEnvironment.ContentRootPath; foreach (var formFile in files) { if (formFile.Length > 0) { string fileExt = GetFileExt(formFile.FileName); //文件扩展名，不含“.” long fileSize = formFile.Length; //获得文件大小，以字节为单位 string newFileName = System.Guid.NewGuid().ToString() + "." + fileExt; //随机生成新的文件名 var filePath = webRootPath +"/upload/" + newFileName; using (var stream = new FileStream(filePath, FileMode.Create)) { await formFile.CopyToAsync(stream); } } } return Ok(new { count = files.Count, size }); }
改为直接从Request.Form.Files中获取文件集合.~
3.使用webUploader上传文件
很久之前..呃..封装过一个webUploader的JS.如下:
对百度WebUploader开源上传控件的二次封装,精简前端代码(两句代码搞定上传)
对百度WebUploader的二次封装,精简前端代码之图片预览上传(两句代码搞定上传)
..我们也用封装好的JS来试试.HTML和JS代码如下,后台代码不需要修改,还是直接从Request.Form.Files获取即可:
<div id="upfliediv"></div>
$(function () { //实例化文件上传 $("#upfliediv").powerWebUpload({ auto: true, fileNumLimit: 1 }); $("#upfliediv").CleanUpload(); })
上传效果如图:
4.文件下载.
上传了文件,我们当然需要下载.
直接通过URL+地址下载是一种极其不安全的方式.这里我们采用返回流的形式来下载.
后台代码如下:
/// <summary> /// 文件流的方式输出 /// </summary> /// <returns></returns> public IActionResult DownLoad(string file) { var addrUrl = file; var stream = System.IO.File.OpenRead(addrUrl); string fileExt = GetFileExt(file); //获取文件的ContentType var provider = new FileExtensionContentTypeProvider(); var memi = provider.Mappings[fileExt]; return File(stream, memi, Path.GetFileName(addrUrl)); }
这里值得注意的是,以前我们想获取ContentType直接使用MimeMapping.GetMimeMapping(file);就好了.
但是这个类是在System.Web下的,core已经抛弃了现有的System.Web.
所以在ASP.NET Core中我们需要通过新的类FileExtensionContentTypeProvider来获取文件的ContentType
编写HTML+JS代码如下(PS:因为是demo,所以写的比较简陋):
<div> <input type="text" id="filename" /><button onclick="downLoad()">下载</button> </div>
function downLoad() { var filename = $("#filename").val(); window.location.href = "@Url.Action("DownLoad")?file=" + filename; }
效果如图:
到此,本篇就结束了,感兴趣的,请点个关注或者推荐.~谢谢.博客也新增了ASP.NET Core的分类文章,以后关于ASP.NET Core的文章都会归类在里面.
