如何修改自定义IModelBinder的默认绑定源？

要让你的Id<TEntity>结构体拥有和int一致的默认绑定源（自动从路由/查询参数绑定，无需显式添加[FromRoute]等注解），可以通过以下步骤实现：

核心思路 #

实现IBindingSourceMetadataProvider接口，在模型元数据初始化阶段为Id<TEntity>类型指定默认绑定源，替代默认的FromBody行为。

实现步骤 #

1. 修改模型绑定提供器，添加绑定源元数据支持 #

更新你的IModelBinderProvider实现，让它同时实现IBindingSourceMetadataProvider，为Id<TEntity>指定默认绑定源为BindingSource.Path（这是int等简单值类型的默认绑定源，支持从路由、查询参数等位置取值）：

public class IdModelBinderProvider : IModelBinderProvider, IBindingSourceMetadataProvider
{
    public IModelBinder GetBinder(ModelBinderProviderContext context)
    {
        if (IsIdType(context.Metadata.ModelType))
        {
            return new IdModelBinder();
        }
        return null;
    }

    public void CreateBindingSourceMetadata(BindingSourceMetadataProviderContext context)
    {
        if (IsIdType(context.Metadata.ModelType))
        {
            // 设置默认绑定源为Path，与int等简单类型行为一致
            context.BindingSource = BindingSource.Path;
        }
    }

    // 辅助方法：判断是否为Id<TEntity>类型
    private static bool IsIdType(Type type)
    {
        return type.IsGenericType && type.GetGenericTypeDefinition() == typeof(Id<>);
    }
}

2. 确保模型绑定器能正确处理路径来源的值 #

你的IdModelBinder需要能从路由/查询参数的字符串值解析出Id<TEntity>实例，示例实现如下：

public class IdModelBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var valueResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        if (valueResult == ValueProviderResult.None)
        {
            return Task.CompletedTask;
        }

        bindingContext.ModelState.SetModelValue(bindingContext.ModelName, valueResult);
        var rawValue = valueResult.FirstValue;

        if (int.TryParse(rawValue, out int intValue))
        {
            // 通过反射创建Id<TEntity>实例
            var idInstance = Activator.CreateInstance(
                bindingContext.ModelType, 
                new object[] { intValue });
            
            bindingContext.Result = ModelBindingResult.Success(idInstance);
        }
        else
        {
            bindingContext.ModelState.TryAddModelError(
                bindingContext.ModelName, 
                $"无法将值 '{rawValue}' 转换为有效的 {bindingContext.ModelType.Name}");
        }

        return Task.CompletedTask;
    }
}

3. 注册自定义模型绑定提供器 #

在Program.cs中，将自定义提供器添加到模型绑定提供器列表的最前面，确保优先被使用：

builder.Services.AddControllers(options =>
{
    options.ModelBinderProviders.Insert(0, new IdModelBinderProvider());
});

效果验证 #

完成以上配置后，你可以直接使用如下控制器方法签名，无需添加任何绑定源注解，Id<Product>会自动从路由参数中绑定，和int参数的行为完全一致：

[HttpGet("{id}")]
public async Task<ActionResult<Product>> GetById(Id<Product> id)
{
    // 业务逻辑
}

内容的提问来源于stack exchange，提问作者Rick de Water