.NET怎么实现文件的上传和下载功能

来源:这里教程网 时间:2026-02-21 17:31:18 作者:

.NET 实现文件上传和下载功能非常常见,尤其是在 Web 应用中。使用 ASP.NET Core 可以轻松实现这些功能,下面分别介绍如何在控制器中处理文件上传和下载。

文件上传

在 .NET 中实现文件上传,通常通过 HTTP POST 请求接收前端提交的文件。ASP.NET Core 提供了 IFormFile 接口来表示上传的文件。

步骤说明:

创建一个 API 或页面接收文件 使用 IFormFile 获取上传的文件流 将文件保存到服务器指定目录或存储服务(如 Azure Blob、MinIO) 示例代码(控制器方法):

[HttpPost("upload")]
public async Task<IActionResult> UploadFile(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("没有选择文件");
    var uploadDir = Path.Combine(Directory.GetCurrentDirectory(), "uploads");
    var filePath = Path.Combine(uploadDir, file.FileName);
    // 确保目录存在
    if (!Directory.Exists(uploadDir))
        Directory.CreateDirectory(uploadDir);
    using (var stream = new FileStream(filePath, FileMode.Create))
    {
        await file.CopyToAsync(stream);
    }
    return Ok(new { message = "文件上传成功", fileName = file.FileName });
}

前端调用示例(HTML):

<form asp-action="UploadFile" method="post" enctype="multipart/form-data">
    <input type="file" name="file" />
    <button type="submit">上传</button>
</form>

文件下载

文件下载是将服务器上的文件发送给客户端。.NET 使用 PhysicalFileFileStreamResult 返回文件内容。

实现方式:

指定要下载的文件路径 检查文件是否存在 返回文件作为响应流 示例代码(控制器方法):

[HttpGet("download/{fileName}")]
public IActionResult DownloadFile(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);
}

或者使用 PhysicalFile 更简洁:

return PhysicalFile(filePath, "application/octet-stream", fileName);

注意事项与安全建议

实际项目中需要注意以下几点:

限制上传文件大小:在 Program.cs 或中间件中配置最大请求体大小 验证文件类型:检查扩展名或文件头,防止恶意文件上传 重命名文件:避免覆盖或路径遍历攻击 使用异步方法提升性能 考虑将文件存入对象存储而非本地磁盘,便于扩展

基本上就这些。上传和下载的核心逻辑简单,关键是做好安全防护和异常处理。

相关推荐

热文推荐