ASP.NET Web API中如何实现等效于ASP.NET Core的Swagger IParameterFilter枚举扩展

经典ASP.NET Web API版本的Swashbuckle组件没有提供独立的IParameterFilter接口，你可以通过IOperationFilter遍历操作下的所有参数，实现和ASP.NET Core版本完全一致的需求。

实现步骤 #

1. 自定义OperationFilter实现参数枚举注入

using Swashbuckle.Swagger;
using System.Web.Http.Description;
using System.Linq;

public class MyParameterOperationFilter : IOperationFilter
{
    public void Apply(Operation operation, SchemaRegistry schemaRegistry, ApiDescription apiDescription)
    {
        // 匹配带自定义约束的路由
        var routeConstraints = apiDescription.Route.Constraints;
        if (routeConstraints == null || !routeConstraints.Values.Any(c => c is MyConstraint))
        {
            return;
        }

        // 遍历所有参数修改枚举值
        foreach (var parameter in operation.parameters)
        {
            // 可按需添加额外匹配规则，比如参数名、参数位置等，避免误修改
            if (parameter.schema != null)
            {
                parameter.schema.@enum = Myvalues.Select(p => (object)p).ToList();
            }
            // 非body类参数（如路径、查询参数）直接取enum字段
            else
            {
                parameter.@enum = Myvalues.Select(p => (object)p).ToList();
            }
        }
    }
}

2. 注册自定义过滤器
   在项目的SwaggerConfig.cs配置文件中，将自定义的OperationFilter注入到Swagger配置中：

GlobalConfiguration.Configuration
    .EnableSwagger(c =>
    {
        // 保留你原有Swagger配置内容
        c.OperationFilter<MyParameterOperationFilter>();
    });

注意事项 #

• 若需要精准匹配特定参数，可在遍历参数时增加parameter.name == "目标参数名"、parameter.@in == "query"/"path"等判断条件，避免修改其他无关参数。
• 如果枚举值为字符串类型，直接赋值即可，无需额外转换为特殊OpenApi类型，Swashbuckle会自动处理序列化逻辑。

内容的提问来源于stack exchange，提问作者Imran Qadir Baksh - Baloch