.NET 实现文件的上传和下载功能在 Web 开发中非常常见，尤其是在 ASP.NET Core 项目中。通过简单的控制器方法和 I/O 操作，就能高效安全地处理文件传输需求。下面介绍如何在 ASP.NET Core 中实现文件的上传与下载功能。
文件上传实现
文件上传通常通过表单提交，使用 IFormFile 接口来接收前端传来的文件数据。
步骤如下：
在前端页面创建支持文件上传的表单，设置 enctype="multipart/form-data" 后端控制器定义接收文件的方法，参数类型为 IFormFile 将文件保存到服务器指定目录，并可返回上传结果示例代码：
[HttpPost("upload")]
public async Task<IActionResult> Upload(IFormFile file)
{
if (file == null || file.Length == 0)
return BadRequest("文件为空");
var uploadDir = Path.Combine(Directory.GetCurrentDirectory(), "uploads");
Directory.CreateDirectory(uploadDir); // 确保目录存在
var filePath = Path.Combine(uploadDir, file.FileName);
await using (var stream = new FileStream(filePath, FileMode.Create))
{
await file.CopyToAsync(stream);
}
return Ok(new { message = "上传成功", fileName = file.FileName });
}
文件下载实现
文件下载是将服务器上的文件以流的形式返回给客户端，触发浏览器下载行为。
关键点：
验证文件是否存在 使用 FileStreamResult 返回文件流 设置合适的响应头（如 Content-Disposition）示例代码：
[HttpGet("download/{fileName}")]
public IActionResult Download(string fileName)
{
var filePath = Path.Combine(Directory.GetCurrentDirectory(), "uploads", fileName);
if (!System.IO.File.Exists(filePath))
return NotFound("文件未找到");
var fileBytes = System.IO.File.ReadAllBytes(filePath);
return File(fileBytes, "application/octet-stream", fileName);
}
说明：返回 File() 方法会自动设置响应类型，第三个参数为下载时的默认文件名。
安全性与优化建议
实际项目中需注意以下几点：
限制上传文件类型（如只允许 .jpg、.pdf） 限制文件大小（可在 Program.cs 或中间件中配置） 对文件名进行重命名，防止路径遍历或覆盖攻击 使用 GUID 生成唯一文件名，避免冲突 考虑将文件存储到云存储（如 Azure Blob、AWS S3）而非本地磁盘例如重命名文件：
var fileExtension = Path.GetExtension(file.FileName); var newFileName = Guid.NewGuid() + fileExtension; var filePath = Path.Combine(uploadDir, newFileName);
前后端配合示例（HTML）
一个简单的上传页面：
<form action="/api/file/upload" method="post" enctype="multipart/form-data"> <input type="file" name="file" required /> <button type="submit">上传文件</button> </form> <a href="/api/file/download/test.pdf">下载示例文件</a>
基本上就这些。只要掌握 IFormFile 和 File 结果的使用，再注意安全规范，.NET 中实现文件上传下载并不复杂但容易忽略细节。
