Asp.Net Core 8中HttpPost+[FromForm]绑定集合对象失败问题

我正在使用Asp.Net Core 8，定义了包含int类型数组的EventIdsWrapper类，在WebAPI控制器的HttpPost接口中用[FromForm]标记该类作为参数，但接收时eventIds.EventIds始终为null。前端发送的表单数据格式为EventIds=xxx&EventIds=xxx...，Content-Type为application/x-www-form-urlencoded，符合官方文档示例，但绑定失败。此前在Asp.Net MVC 5中使用[FromBody]可正常工作。

更新：直接将接口参数改为[FromForm] int[] EventIds时可正常绑定。想了解为何包装类的方式无法生效，以及多表单数据场景下是否必须将数组单独绑定？

一、包装类绑定失败的原因 #

Asp.Net Core的[FromForm]模型绑定规则和Asp.Net MVC 5存在差异：

• 当参数是**复杂类型（如你的EventIdsWrapper）**时，模型绑定默认会按照「控制器参数名.类属性名」的格式匹配表单字段。比如你的控制器方法参数是[FromForm] EventIdsWrapper eventIds，模型绑定会尝试寻找eventIds.EventIds这个字段名，而你前端发送的是EventIds=xxx，两者不匹配，所以EventIds属性会被设为null。
• 当直接用int[] EventIds作为参数时，表单字段名EventIds和参数名完全一致，模型绑定可以直接匹配，因此能成功绑定。

二、多表单数据场景无需单独绑定数组 #

你可以通过两种方式解决包装类的绑定问题，无需将数组单独提取为参数：

1. 调整前端请求格式：将表单字段名改为eventIds.EventIds，比如发送eventIds.EventIds=1&eventIds.EventIds=2，这样就能匹配包装类中的EventIds属性。
2. 修改后端属性配置：在EventIdsWrapper类的EventIds属性上添加[BindProperty(Name = "EventIds")]特性，显式指定该属性绑定到表单中的EventIds字段，示例代码如下：

public class EventIdsWrapper
{
    [BindProperty(Name = "EventIds")]
    public int[] EventIds { get; set; }
}

这样前端无需修改原有请求格式，包装类就能正确接收数组数据。

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