如何禁止ASP.NET中Enum类型Action参数接收整数值？

要实现仅允许传入枚举的字符串值作为ASP.NET Action的参数，你可以通过自定义模型绑定器来覆盖默认的枚举绑定行为——默认行为会接受整数甚至无效的整数值并强行转换为枚举类型。下面是具体的实现方案：

1. 创建自定义枚举模型绑定器 #

这个绑定器会只接受有效的枚举字符串名称，拒绝整数或无效的字符串值：

public class StringOnlyEnumModelBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        if (bindingContext == null)
            throw new ArgumentNullException(nameof(bindingContext));

        var valueProviderResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        if (valueProviderResult == ValueProviderResult.None)
            return Task.CompletedTask;

        bindingContext.ModelState.SetModelValue(bindingContext.ModelName, valueProviderResult);

        var value = valueProviderResult.FirstValue;
        if (string.IsNullOrEmpty(value))
            return Task.CompletedTask;

        // 校验是否为当前枚举的有效字符串名称
        if (Enum.TryParse(bindingContext.ModelType, value, ignoreCase: false, out var result) && 
            Enum.IsDefined(bindingContext.ModelType, result))
        {
            bindingContext.Result = ModelBindingResult.Success(result);
        }
        else
        {
            bindingContext.ModelState.AddModelError(bindingContext.ModelName, 
                $"无效参数值：{value}，必须是{bindingContext.ModelType.Name}枚举的有效字符串名称");
        }

        return Task.CompletedTask;
    }
}

2. 注册绑定器（两种可选方式） #

方式一：全局注册（对所有枚举参数生效） #

在Program.cs（.NET 5+）或Startup.cs中配置MVC服务时，添加自定义绑定器提供者：

// 先定义绑定器提供者类
public class EnumModelBinderProvider<TBinder> : IModelBinderProvider where TBinder : IModelBinder, new()
{
    public IModelBinder GetBinder(ModelBinderProviderContext context)
    {
        if (context.Metadata.ModelType.IsEnum)
            return new TBinder();

        return null;
    }
}

// 注册到服务中
builder.Services.AddControllers(options =>
{
    // 将自定义绑定器放在提供者列表最前面，确保优先使用
    options.ModelBinderProviders.Insert(0, new EnumModelBinderProvider<StringOnlyEnumModelBinder>());
});

方式二：针对单个参数标记（仅对指定参数生效） #

先创建一个绑定器特性：

public class StringOnlyEnumAttribute : ModelBinderAttribute
{
    public StringOnlyEnumAttribute() : base(typeof(StringOnlyEnumModelBinder))
    {
    }
}

然后在Action的枚举参数上添加该特性：

public enum SomeEnum { SomeVal1 = 1, SomeVal2 = 2 }

[HttpGet]
public void SomeAction([StringOnlyEnum] SomeEnum someParameter) 
{ 
    // 你的业务逻辑代码
}

3. 验证效果 #

配置完成后：

• 传入http://host/SomeController/SomeAction/SomeVal1会正常绑定参数；
• 传入http://host/SomeController/SomeAction/1或http://host/SomeController/SomeAction/54时，ASP.NET会返回400 Bad Request，并在模型错误信息中提示无效参数。

如果需要支持大小写不敏感的字符串匹配，只需将Enum.TryParse方法中的ignoreCase参数改为true即可。

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