.NET 拓展Swagger之【添加注释

修改配置

#region Swagger的配置

builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen(option =>
{
    // xml 文档文件绝对路径--读取根据控制器生成的xml文件
    var file = Path.Combine(AppContext.BaseDirectory,
        "ZhaoXi.WebSiteApi.xml");
    // true: 显示控制器层注释
    option.IncludeXmlComments(file, true);
    // 对actuin的名称进行排序，如果有多个，就可以看到效果
    option.OrderActionsBy(o => o.RelativePath);
});
#endregion 

修改属性

重新生成文件

查看xml

注意：xml文件名称要一致，否则运行时会报错

测试

控制器注释

实体类注释

下一节

.NET 拓展Swagger之【版本控制】 - 掘金 (juejin.cn)