Swashbuckle中的自定义SchemaFilter以显示带有描述的枚举，但更改输入值

Swashbuckle是一个用于生成和展示API文档的开源工具，它与ASP.NET Core Web API框架集成。自定义SchemaFilter是Swashbuckle提供的一种扩展机制，用于自定义API文档中枚举类型的展示方式。

枚举类型是一种特殊的数据类型，它包含一组预定义的常量值。在API文档中，通常需要展示枚举类型的取值范围和描述信息，以便开发者能够理解和正确使用API。

通过自定义SchemaFilter，我们可以实现在API文档中显示带有描述的枚举。具体步骤如下：

创建一个实现了ISchemaFilter接口的自定义枚举SchemaFilter类。ISchemaFilter接口定义了一个Apply方法，用于修改Swagger中的架构（Schema）对象。
在Apply方法中，判断当前架构对象是否为枚举类型。如果是枚举类型，则获取枚举的描述信息，并将其添加到架构对象的描述字段中。
在Startup.cs文件中的ConfigureServices方法中，注册自定义的枚举SchemaFilter。可以使用AddSwaggerGen方法来配置Swashbuckle生成API文档的选项。

下面是一个示例代码：

using Swashbuckle.AspNetCore.SwaggerGen;
using System;
using System.Linq;
using System.Reflection;

public class EnumSchemaFilter : ISchemaFilter
{
    public void Apply(Schema schema, SchemaFilterContext context)
    {
        if (context.Type.IsEnum)
        {
            var enumValues = Enum.GetValues(context.Type);

            schema.Description += $"Possible values: {string.Join(", ", enumValues)}. ";
            
            foreach (var enumValue in enumValues)
            {
                var memberInfo = context.Type.GetMember(enumValue.ToString()).FirstOrDefault();
                var enumDescription = memberInfo?.GetCustomAttribute<DescriptionAttribute>()?.Description;
                
                if (!string.IsNullOrEmpty(enumDescription))
                {
                    schema.Description += $"{enumValue}: {enumDescription}. ";
                }
            }
        }
    }
}

在上述示例中，我们通过遍历枚举类型的取值，获取每个取值的描述信息，并将其添加到架构对象的描述字段中。

要使用自定义的枚举SchemaFilter，只需在Startup.cs文件中的ConfigureServices方法中注册它：

services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
    c.SchemaFilter<EnumSchemaFilter>();
});

这样，当使用Swashbuckle生成API文档时，枚举类型的描述信息将会显示在文档中。

推荐的腾讯云相关产品：腾讯云API网关（API Gateway）。腾讯云API网关是一种全托管的API服务，可帮助开发者更好地管理和发布API，并提供了丰富的功能和工具来简化API的开发和维护工作。您可以通过以下链接了解更多关于腾讯云API网关的信息：腾讯云API网关

请注意，以上答案仅供参考，具体实现方式可能因不同的技术栈和版本而有所差异。在实际应用中，建议查阅相关文档和资料，以确保正确使用Swashbuckle和自定义SchemaFilter。