.NET怎么实现文件的上传和下载功能_文件上传下载实现教程-C#.Net教程-PHP中文网

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

月夜之吻

发布： 2025-11-09 21:56:03

原创

236人浏览过

答案：ASP.NET Core通过IFormFile处理上传，FileResult实现下载。首先前端表单需设置enctype为multipart/form-data，后端用IFormFile接收文件，保存至指定目录；下载时验证文件存在性，读取字节流并返回FileStreamResult，设置Content-Disposition响应头触发下载。安全方面应限制文件类型与大小，重命名文件为GUID避免冲突，推荐存储至云服务如Blob或S3。示例代码包含上传接口/post upload和下载接口/get download/{fileName}，配合HTML表单可完成基本功能。

.net怎么实现文件的上传和下载功能_文件上传下载实现教程

.NET 实现文件的上传和下载功能在 Web 开发中非常常见，尤其是在 ASP.NET Core 项目中。通过简单的控制器方法和 I/O 操作，就能高效安全地处理文件传输需求。下面介绍如何在 ASP.NET Core 中实现文件的上传与下载功能。

文件上传实现

文件上传通常通过表单提交，使用 IFormFile 接口来接收前端传来的文件数据。

步骤如下：

在前端页面创建支持文件上传的表单，设置 enctype="multipart/form-data"
后端控制器定义接收文件的方法，参数类型为 IFormFile
将文件保存到服务器指定目录，并可返回上传结果

示例代码：

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

[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 中实现文件上传下载并不复杂但容易忽略细节。

以上就是.NET怎么实现文件的上传和下载功能_文件上传下载实现教程的详细内容，更多请关注php中文网其它相关文章！