xml - 抑制 ServiceReference .cs 文件的 Xml 警告

Question

使用 MVC4 和 VS2012，我使用的是 Service Reference，它会自动生成一个 Reference.cs 文件。当我构建时，我收到了数十条错误警告

'Missing XML comment for publicly visible type or member...'

我找到了类似的答案 here ，它引用了在此 blog 中找到的解决方法，建议将以下修复添加到 CSProj 文件中:

<Target Name="XamlGeneratedCodeWarningRemoved" AfterTargets="XamlMarkupCompilePass1">
    <Exec Command="for %%f in (@(XamlGeneratedCodeFiles)) do echo #pragma warning disable > %%f.temp" />
    <Exec Command="for %%f in (@(XamlGeneratedCodeFiles)) do type %%f >> %%f.temp" />
    <Exec Command="for %%f in (@(XamlGeneratedCodeFiles)) do copy /y %%f.temp %%f" />
    <Message Text="XamlGeneratedCodeWarningRemoved: @(XamlGeneratedCodeFiles)" />
  </Target>

但这似乎不适用于 Reference.cs 文件，可能是因为它针对的是 Xaml？谁能告诉我如何解决此问题以使用 Reference.cs 文件或建议另一种方法来解决此问题？

我不能只在自动生成的代码中添加 pragma disable 或禁用 Xml 注释。

Answer 1

动态更新预生成的 .cs 文件将 cause all sorts of issues with Visual Studio, since it will use the in-memory copy of the files .由于源代码管理集成使文件成为只读文件并要求在每次构建后 checkin 文件，这将非常令人恼火。

您还可以通过调整服务客户端的属性使其成为内部服务客户端。根据您的设置，文档生成不会提示任何外部不可见的方法。不过，这可能仍会触发 StyleCop、代码分析或 Resharper 警告...

所以我通常做的是，我将服务引用粘贴到他们自己的 Visual Studio 项目中，将生成的代码公开并关闭整个项目的文档生成。这还有一个好处，即无论您将其包含在哪个项目中，您的服务引用都将使用相同的绑定(bind)。