显示（值）DataAnnotations - Swashbuckle - Swagger 页面

Question

是否可以在 Swagger 页面上显示参数的 DataAnnotations，例如最小值和最大值？

我已经尝试将 ShowExtensions 和 ShowCommonExtension 设置为 true 或调用 ShowExtensions()，但并没有解决问题。 Range 属性和/或例如Swagger 页面上不显示字符串的 MaxLength(20)。

启动（代码 sn-p）

    app.UseSwaggerUI(
        options =>
        {
            options.ConfigObject = new ConfigObject
            {
                ShowCommonExtensions = true,
                ShowExtensions = true
            };

            options.ConfigObject.AdditionalItems.Add("showCommonExtensions", true);

            options.ShowExtensions();

框架/包

• .NET Core 3.1
• Swashbuckle.AspNetCore (5.4.1)
• Swashbuckle.AspNetCore.SwaggerGen (5.4.1)

控制器（代码 sn-p）

 [HttpGet]
 public IEnumerable<string> GetMethod([Required] [Range(1, 10)] int value)
 {

Swagger 用户界面

Answer 1

我做了更多的挖掘......

他们确实检查了多个属性：

https://github.com/domaindrivendev/Swashbuckle.AspNetCore/blob/316ddd0fe6768f470c274a0e93c789b65cf658b9/src/Swashbuckle.AspNetCore.SwaggerGen/SchemaGenerator/OpenApiSchemaExtensions.cs#L12

if (attribute is DefaultValueAttribute defaultValue && defaultValue.Value != null)
{
    schema.Default = OpenApiAnyFactory.CreateFor(schema, defaultValue.Value);
}
else if (attribute is RegularExpressionAttribute regex)
{
    schema.Pattern = regex.Pattern;
}
else if (attribute is RangeAttribute range)
{
    schema.Maximum = decimal.TryParse(range.Maximum.ToString(), out decimal maximum)
        ? maximum
        : schema.Maximum;

    schema.Minimum = decimal.TryParse(range.Minimum.ToString(), out decimal minimum)
        ? minimum
        : schema.Minimum;
}

但我看到的唯一使用范围的 UnitTest 是在模型上：

https://github.com/domaindrivendev/Swashbuckle.AspNetCore/blob/47684caeeaaeb4d887236e61a2ea35e4dc76b958/test/Swashbuckle.AspNetCore.TestSupport/Fixtures/DataAnnotatedViaMetadataType.cs#L26

    public class MetadataType
    {
        [Required]
        public string StringWithRequired { get; set; }

        [Required]
        public int IntWithRequired { get; set; }

        [Range(1, 12)]
        public int IntWithRange { get; set; }

        [RegularExpression("^[3-6]?\\d{12,15}$")]
        public string StringWithRegularExpression { get; set; }
    }

如果这是您真正关心的问题，请填写错误报告：
https://github.com/domaindrivendev/Swashbuckle.AspNetCore/issues/new