自定义模型绑定器可控制请求数据映射方式，通过实现IModelBinder接口解析特殊格式如"10-20"到Range对象，并在Program.cs注册或使用[ModelBinder]特性应用，提升复用性与控制器简洁性。
在 ASP.NET Core 中，自定义模型绑定器允许你控制请求数据如何映射到控制器操作的参数上。当你需要处理特殊格式的数据（如自定义字符串解析、复杂对象构造或非标准输入）时，可以创建自定义模型绑定器。
1. 创建自定义模型绑定器
自定义模型绑定器需实现 IModelBinder 接口，重写 BindModelAsync 方法。该方法从 HTTP 请求中提取数据并转换为指定类型。
示例：绑定一个表示范围的字符串（如 "10-20"）到 Range 类型
public class Range
{
public int Start { get; set; }
public int End { get; set; }
}
public class RangeModelBinder : IModelBinder
{
public Task BindModelAsync(ModelBindingContext bindingContext)
{
var valueProvider = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
if (string.IsNullOrEmpty(valueProvider.FirstValue))
{
return Task.CompletedTask;
}
var value = valueProvider.FirstValue;
var parts = value.Split('-');
if (parts.Length == 2 && int.TryParse(parts[0], out int start) && int.TryParse(parts[1], out int end))
{
var range = new Range { Start = start, End = end };
bindingContext.Result = ModelBindingResult.Success(range);
}
else
{
bindingContext.ModelState.AddModelError(bindingContext.ModelName, "Invalid range format. Use 'start-end'.");
bindingContext.Result = ModelBindingResult.Failed();
}
return Task.CompletedTask;
}
}2. 创建模型绑定器工厂（可选）
如果希望根据条件动态选择绑定器，可实现 IModelBinderProvider。但大多数情况下，直接注册绑定器更简单。
若要为特定类型全局使用绑定器，可以通过提供程序返回绑定器实例：
public class RangeModelBinderProvider : IModelBinderProvider
{
public IModelBinder GetBinder(ModelBinderProviderContext context)
{
if (context.Metadata.ModelType == typeof(Range))
{
return new RangeModelBinder();
}
return null;
}
}3. 注册自定义模型绑定器
在 Program.cs 或 Startup.cs 中将绑定器或提供程序添加到 MVC 配置中。
builder.Services.AddControllers(options =>
{
options.ModelBinderProviders.Insert(0, new RangeModelBinderProvider());
});或者，不使用提供程序，可在参数上直接使用 [ModelBinder] 特性：
[HttpGet("data")]
public IActionResult GetData([ModelBinder(BinderType = typeof(RangeModelBinder))] Range range)
{
if (range == null)
return BadRequest("Invalid range");
return Ok($"Start: {range.Start}, End: {range.End}");
}4. 使用场景说明
- 解析自定义格式字符串（如 CSV、坐标、时间区间）
- 合并多个请求字段到一个对象（如把 query 中的 page 和 size 合成 Pagination 参数）
- 兼容旧版 API 的非常规输入
自定义模型绑定器提升代码复用性和控制器简洁性。只要绑定逻辑通用或复杂，就适合封装进绑定器。
基本上就这些。
