C# 如何在 ASP.NET Core 中上传文件_C# ASP.NET Core 文件上传实现指南

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

C# 如何在 ASP.NET Core 中上传文件_C# ASP.NET Core 文件上传实现指南

2025-11-03

浏览次数：次

返回列表

答案：ASP.NET Core通过IFormFile实现文件上传，支持单多文件、大文件限制及安全验证。使用IFormFile接收文件，配置FormOptions调整大小限制，结合RequestSizeLimit特性，前端表单需设multipart/form-data编码，建议验证扩展名、MIME类型并重命名文件以保障安全。

c# 如何在 asp.net core 中上传文件_c# asp.net core 文件上传实现指南

在 ASP.NET Core 中实现文件上传是一个常见需求，比如用户上传头像、文档或附件。实现方式简单高效，同时支持单文件和多文件上传，并能有效处理大文件和安全限制。

启用文件上传的控制器配置

ASP.NET Core 使用 IFormFile 接口来表示通过 HTTP 请求上传的文件。你需要在控制器中创建一个接收该类型的参数的方法。

确保控制器允许表单数据提交：

[HttpPost("upload")]
public async Task<IActionResult> UploadFile(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("No file uploaded.");

    var filePath = Path.Combine(Directory.GetCurrentDirectory(), "uploads", file.FileName);

    using (var stream = new FileStream(filePath, FileMode.Create))
    {
        await file.CopyToAsync(stream);
    }

    return Ok($"File {file.FileName} uploaded successfully.");
}

注意：确保目标目录（如 uploads）存在，否则会抛出异常。

支持多文件上传

如果需要一次上传多个文件，可以将参数改为 IFormFileCollection 或 IEnumerable。

[HttpPost("upload-multiple")]
public async Task<IActionResult> UploadMultipleFiles(IEnumerable<IFormFile> files)
{
    foreach (var file in files)
    {
        if (file.Length > 0)
        {
            var filePath = Path.Combine("uploads", file.FileName);
            using (var stream = new FileStream(filePath, FileMode.Create))
            {
                await file.CopyToAsync(stream);
            }
        }
    }
    return Ok($"{files.Count()} files uploaded.");
}

前端 HTML 表单示例

上传页面需要使用 multipart/form-data 编码类型：

<form method="post" enctype="multipart/form-data&quot; action="/upload">
    <input type="file" name="file" />
    <button type="submit">Upload</button>
</form>

对于多文件上传，添加 multiple 属性：

Pippit AI

CapCut推出的AI创意内容生成工具

133 查看详情 Pippit AI

<input type="file" name="files" multiple />

配置文件大小和请求限制

默认情况下，ASP.NET Core 限制请求体大小（通常为 30MB），大文件上传需调整设置。

在 Program.cs 中配置：

builder.Services.Configure<FormOptions>(options =>
{
    options.MultipartBodyLengthLimit = 52428800; // 50 MB
});

也可使用 RequestSizeLimit 特性控制特定 Action：

[RequestSizeLimit(100_000_000)] // 100 MB
[HttpPost("upload-large")]
public async Task<IActionResult> UploadLargeFile(IFormFile file)
{
    // 处理逻辑
}

安全与验证建议

直接保存上传文件存在风险，应加入以下检查：

验证文件扩展名，避免可执行文件（.exe, .bat, .asp 等）
检查 MIME 类型是否匹配
重命名上传文件，防止路径遍历攻击
限制文件大小
扫描病毒（生产环境建议集成防病毒服务）

示例：检查扩展名

var allowedExtensions = new[] { ".jpg", ".png", ".pdf" };
var ext = Path.GetExtension(file.FileName).ToLowerInvariant();
if (!allowedExtensions.Contains(ext))
    return BadRequest("Invalid file type.");

基本上就这些。ASP.NET Core 的文件上传机制灵活且易于扩展，结合中间件还可实现进度反馈、分片上传等功能。关键是做好输入验证和资源管理，避免安全隐患。

以上就是C# 如何在 ASP.NET Core 中上传文件_C# ASP.NET Core 文件上传实现指南的详细内容，更多请关注其它相关文章！

# 前端 # 如何在 # 文档 # 大文件 # 扩展名 # 表单 # 如何实现 # 上传文件 # 上传 # .net # c# # 配置文件 # stream # pdf # ai # 编码 # html # 文件上传 # 免费优化网站文件 # 南京网站建设答疑解惑 # seo 常用浏览器插件 # 银川网站建设方案表 # 白山抖音关键词排名方法 # 明星搜索网站建设 # 英语培训网站建设 # 自动网站建设系统cms # 南山全网推广营销平台 # 上林全网营销推广