运行时类型的ASP.NET核心ModelBinding

基础概念

ModelBinding 是 ASP.NET Core 中的一个核心功能，它负责将 HTTP 请求中的数据绑定到模型对象上。这个过程通常发生在控制器处理请求时，通过 ModelBinder 实现数据的自动映射。

类型

简单类型绑定：如 int, string, bool 等。
复杂类型绑定：自定义类或结构体。
集合类型绑定：如 List<T>, Dictionary<TKey, TValue> 等。
文件上传绑定：通过 IFormFile 接口实现。

应用场景

表单提交：将 HTML 表单中的数据绑定到模型对象。
API 请求：处理 RESTful API 的请求体数据。
路由参数：将 URL 路由中的参数绑定到模型属性。

可能遇到的问题及原因

数据不匹配：请求中的字段名称与模型属性不一致。
类型转换错误：请求数据无法正确转换为模型属性的类型。
缺少必填字段：模型属性标记为 [Required]，但请求中未提供相应数据。

解决方法

数据不匹配

确保请求中的字段名称与模型属性名称一致，或者在模型属性上使用 [BindProperty(Name = "requestFieldName")] 属性进行映射。

public class MyModel
{
    [BindProperty(Name = "user_name")]
    public string UserName { get; set; }
}

类型转换错误

检查请求数据的格式是否正确，或者在模型属性上使用 [FromBody] 属性明确指定数据来源。

[HttpPost]
public IActionResult Create([FromBody] MyModel model)
{
    if (ModelState.IsValid)
    {
        // 处理逻辑
    }
    return BadRequest(ModelState);
}

缺少必填字段

确保请求中包含所有必填字段，或者在控制器方法中进行手动验证。

[HttpPost]
public IActionResult Create(MyModel model)
{
    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState);
    }
    // 处理逻辑
}

示例代码

假设有一个简单的模型和一个控制器方法：

public class User
{
    [Required]
    public string Name { get; set; }
    public int Age { get; set; }
}

[ApiController]
[Route("api/[controller]")]
public class UsersController : ControllerBase
{
    [HttpPost]
    public IActionResult CreateUser([FromBody] User user)
    {
        if (!ModelState.IsValid)
        {
            return BadRequest(ModelState);
        }
        // 处理用户创建逻辑
        return CreatedAtAction(nameof(GetUser), new { id = user.Id }, user);
    }
}

在这个例子中，CreateUser 方法会自动将请求体中的 JSON 数据绑定到 User 对象上，并进行基本的验证。

通过这种方式，ASP.NET Core 的 ModelBinding 功能可以大大简化数据处理的复杂性，提高开发效率和应用的可维护性。