友好的注释能提高代码的可读性,几乎所有的编程语言都支持注释. 在C#中,注释不是可执行代码的一部分,因此注释不会被编译到程序集中去,但是我们可以提取注释[右键项目]-[属性]-[生成]-[输出]-[Xml文档文件]: 如果勾选了输出注释,那么VS在没有注释的方法.类型.属性等地方将会抛出警告,提醒添加注释,而添加1591代码可以取消这种无注释警告. 一般时候,我们并不会在代码中操作注释,但是如果需要,我们可以从这个生成的xml文件中去获取注释,swagger也是这么做的. 首先,创建一个辅助类: