XML中的Swagger留档不显示查询对象参数的架构

Question

两种情况下生成的 XML 文件相同

<?xml version="1.0"?>
<doc>
    <assembly>
        <name>DateTimeServiceAPI</name>
    </assembly>
    <members>
        <member name="P:DateTimeServiceAPI.DTOs.GetCurrentTimeDTO.TenantId">
            <summary>
            indentifer of the tenant
            </summary>
        </member>
    </members>
</doc>

知道为什么在生成文档时会有这种差异吗？我在搜索此内容时找不到任何相关内容。

如何（强制）将所有数据模型包含在模式部分中？非常感谢任何指针或资源。

谢谢你

Answer 1

您应该检查您的GetCurrentTimeDTO模型，用作控制器方法参数的DTO的属性应该设置public，如果它是internalorprivate

public class MyDto
{
    public Guid Id { get; internal set; } // Not shown
    public DateTime Date { get; set; } //shown
}

Answer 2

您是否尝试过在 swagger 中明确包含文档？