最近在写web api的项目,用到微软的Web api help page组件,用于自动对生成API文档,见博文: https://www.cnblogs.com/lenmom/p/9081363.html, 效果很好,但是问题来了,今天打开代码一看,好多警告
CS1591 缺少对公共可见类型或成员的 XML 注释
这是由于代码编写不规范造成的,为了消除这些警告,可能的方法如下:
1. 项目->属性-生成,禁止限制警告,输入1591,警告编号,这是针对整个项目级别的
2. 代码中加入一下代码,用于禁止警告,注意,这个只是针对文件级别的
#pragma warning disable 1591
如果想要恢复显示警告提示,则使用以下语句
#pragma warning restore 1591
3. 不生成xml文档,则不会显示该警告,但是在该场景中不使用本方法。