.net5使用 swagger作为接口文档使用教程

备注:.netcore3.1 版本后都统一叫.net了,目前(2021/03/09)稳定版是.net5

 

 红色添加的部分是使用swagger的方式;

黄色圈的部分是应用了swagger接口文档描述,即生成了对接口(controller)的注释说明;

上面配置文件中的xml文件是通过下面这个设置生成的:

 

另外,还需要注意的一点是,当我们勾选上了 XML documentation file,编辑器会生成一条警告信息,这个我们可以通过添加排除警告号来解决:

 参考:https://www.cnblogs.com/shanfeng1000/p/13476831.html

原文地址:https://www.cnblogs.com/lishidefengchen/p/14505113.html