Swashbuckle 如何显示示例字典而不是additionalProp？

Question

我有一个 API，我希望 swashbuckle 为我自动生成所有 swagger 文档。

我有一个端点，它返回一个带有字典属性的类，但 swagger 生成的示例包含“additionalProp1、additionalProp2”等而不是示例值。有没有办法改为使用SimpleClass类中指定的示例值？

带有 swagger 示例的类（不起作用）。

public class SimpleClass
{
    /// <example>"{"age":31,"height":234}"</example>
    public Dictionary<string, int> DictionaryProperty { get; set; }

    /// <example>The cow jumped over the moon</example>
    public string someProperty { get; set; }
}

控制器

    [HttpGet]
    [Route("/testexample")]
    [ProducesResponseType(typeof(SimpleClass), StatusCodes.Status200OK)]
    public async Task<IActionResult> TestExample()
    {
        return Ok();
    }

招摇的结果：

Answer 1

取出 XMLexample值中的引号：

/// <example>{"age":31,"height":234}</example>