c# - Swagger UI 响应示例 Asp.Net Core Web Api

Question

我正在使用 Swagger.AspNetCore 来记录我的 api。到目前为止，我很高兴使用 xml 注释来生成响应模型示例，直到我必须记录嵌入对象。

所以我有简单的模型：

public class SummaryResult
{
    /// <summary>Total Cost.</summary>
    /// <value>Total Cost.</value>
    /// <example>6433.2</example>
    public double TotalCost { get; set; }

    /// <summary>Owner.</summary>
    public Owner Owner { get; set; }
}

public class Owner
{
    /// <summary>Owner Name.</summary>
    /// <value>Owner Name.</value>
    /// <example>Michael</example>
    public string Name { get; set; }
}

Swagger UI 仅针对 TotalCost 记录它，所有者属性只是跳过了我所做的任何事情。有谁知道为什么会发生这种情况？以及如何解决它。
我知道如何处理 List - 只需将顶部的 xml 注释放在上面，<list></list>但这不是我的情况。

谢谢

Answer 1

我刚刚对此进行了测试，结果显示效果很好：
http ://swagger-net-test.azurewebsites.net/swagger/ui/index#/ActionFilter/ActionFilter_Get

这是模型选项卡上的样子：

正如您在图像中看到的那样，它确实显示了摘要和示例值。

这是代码：
https ://github.com/heldersepu/Swagger-Net-Test/blob/master/Swagger_Test/Controllers/ActionFilterController.cs#L29

有根据的猜测可能还有其他东西可以删除这些元素。