ASP.NET MVC中如何将多个文件输入绑定到IEnumerable集合？

核心解决思路 #

ASP.NET MVC的模型绑定需要索引式命名格式来识别集合中的元素，同时要确保每个文件输入对应一个完整的Document对象（包含DocumentType和File），且表单需配置支持文件上传的编码类型。

步骤1：修改视图输入控件 #

每个独立文件输入需搭配隐藏字段指定对应的DocumentType，并使用Documents[N].xxx的命名格式（N为从0开始的连续索引）：

<form method="post" enctype="multipart/form-data">
    <!-- 医疗证明文件 -->
    <input type="hidden" name="Documents[0].DocumentType" value="MedicalCertificate" />
    <input type="file" name="Documents[0].File" id="medical-certificate-file" />

    <!-- 经理学位文件 -->
    <input type="hidden" name="Documents[1].DocumentType" value="ManagerDegree" />
    <input type="file" name="Documents[1].File" id="manager-degree-doc-file" />

    <!-- 更多文件输入可按此格式扩展，索引依次递增 -->
    <button type="submit">提交</button>
</form>

步骤2：调整模型集合类型 #

将InputModel中的IEnumerable<Document>改为List<Document>（IEnumerable为只读类型，模型绑定需要可实例化的集合）：

public class Document
{
    public DocumentType DocumentType { get; set; }
    public IFormFile File { get; set; }
}

public class InputModel
{
    public List<Document> Documents { get; set; } = new List<Document>();
}

步骤3：控制器接收绑定数据 #

在Post方法中直接接收InputModel参数，模型绑定会自动将所有文件和对应类型映射到集合中：

[HttpPost]
public IActionResult SubmitForm(InputModel model)
{
    foreach (var document in model.Documents)
    {
        if (document.File != null && document.File.Length > 0)
        {
            // 执行文件保存或业务逻辑
            // 示例：var fileName = Path.GetFileName(document.File.FileName);
            // var filePath = Path.Combine(_webHostEnvironment.WebRootPath, "uploads", fileName);
            // await document.File.CopyToAsync(new FileStream(filePath, FileMode.Create));
        }
    }
    return RedirectToAction("Index");
}

常见问题说明 #

• 之前使用Documents.File命名失败：此格式仅能绑定单个File属性，多个文件会互相覆盖，无法区分不同的Document对象。
• asp-for="Documents.ElementAt(0).File"无效：模型绑定无法识别ElementAt方法，必须使用索引器Documents[0].File的格式才能被正确解析。

内容的提问来源于stack exchange，提问作者Mladen Nikolov