xml - 在生成的接口中排除 XML 注释

Question

我有一个从服务引用生成的接口。该界面缺少 XML 注释，因此我收到警告（在我的 VS 配置中作为错误处理）。如何从警告中排除此接口？

Answer 1

看看这个 MS 论坛对这个问题的讨论：

http://social.msdn.microsoft.com/Forums/en-US/9bbad4cc-e229-49da-a6f7-3cdf470ac53a/compiler-warning-for-missing-xml-comment-when-i-have-generated-code？论坛=开发文档

总结（阅读：复制-n-粘贴）线程中的一些可能的解决方案：

• 通过在项目属性的 Build 选项卡上的 Suppress Warnings 字段中输入它的编号（对于 C# 为 1591）来抑制警告。注意：这将抑制项目中所有代码文件的1591 。

• 更新自动生成文件的模板，添加#pragma warning disable 1591 （参见http://msdn.microsoft.com/en-us/library/ms185319(VS.90).aspx）

• 右键单击服务引用并选择将“生成的类的访问级别”配置更改为内部。单击确定。

• 修改 MSBuild 目标文件以包含注入 1591 杂注的 AfterTarget： http ://lvquoc.blogspot.com/2010/11/disable-xml-comment-warning-in-workflow.html

• 将生成的代码移动到单独的项目中，并禁用该项目上的 XML 文档。

如果您不打算经常或根本不打算重新生成此文件，您可以随时打开 reference.cs 文件并自己将#pragma 添加到文件的顶部和底部：...edit the Reference.cs file itself and add "#pragma warning disable 1591" at the top and "#pragma warning restore 1591" at the bottom.