如何在Swagger中显示查询参数的c#验证属性

Question

我正在用ASP。Net核心2.1 Web API项目。下面是一个示例控制器操作方法：

[HttpGet]
public string GetString([Required, MaxLength(20)] string name) =>
    $"Hi there, {name}.";

这是我在 Swagger 文档中得到的内容。如您所见，Swagger 显示“必需”属性，但不显示“最大长度”属性：

如果我在一个DTO类上使用< code>Required和< code>MaxLength属性，这是一个POST操作方法的参数，那么Swagger会显示这两个属性:

如何让Swagger显示查询参数的MaxLength（和其他）验证属性？

注意：我试图用一个类替换＜code＞字符串名称

Answer 1

在 .NET Core 中，可以使用具有给定顺序的“显示共同扩展 = true”（“配置对象”位于顶部）。

public static IApplicationBuilder UseR6SwaggerDocumentationUI(
            this IApplicationBuilder app)
{
    app.UseSwagger();
    app.UseSwaggerUI(c =>
    {
        //Allow to add addition attribute info on doc. like [MaxLength(50)]
        c.ConfigObject = new ConfigObject
        {
            ShowCommonExtensions = true
        };

        c.SwaggerEndpoint("/swagger/v1/swagger.json", "Asptricks.net API");
        c.RoutePrefix = "api_documentation/index";
        c.InjectStylesheet("/swagger-ui/custom.css");
        c.InjectJavascript("/swagger-ui/custom.js");
        c.SupportedSubmitMethods( new[] { SubmitMethod.Patch });

        //Collapse model near example.
        c.DefaultModelExpandDepth(0);

        //Remove separate model definition.
        c.DefaultModelsExpandDepth(-1);
    });

    return app;
}