在Visual Studio 2010中记录(XML)应用程序设置

我最近使用Visual Studio(2010)创建了一个(C#)项目并使用了一些设置(我在Properties下创建)。

我找到的唯一可以在我的文档中添加XML注释的地方是Settings.Designer.cs。 但是,此文件是自动生成的,因此每当我更改“设置”时,注释都会消失。

即使是Visual Studio也开始提供mewarnings,“缺少XML评论,以便宣传明显的类型或成员….”

我的问题是:将XML注释添加到我的设置的最佳方法是什么?

  • 有没有比Settings.Designer.cs更好的地方?
  • 我应该停止自动生成文件吗? 怎么样?
  • 还有别的办法吗?

顺便说一句,我正在使用Sandcastle帮助文件生成器

如果打开设置(使用默认设计器),则可以在属性窗口中找到属性“描述”。 填写它,它将用作自动生成文件中的XML注释摘要。

在Settings.settings文件中(不要使用设计器打开它),添加一个属性,例如“Description”:

 42  

这将产生

 ///  /// This property does blah blah blah ///  [global...] public int MySetting { ... 

您还可以构建一个获取Settings.settings文件并创建MAML主题文件的工具。 在项目的构建事件中调用该工具并进行操作。

在我的测试中,如果您将描述作为Setting元素的属性,那么如果您更改设计器中的设置,它将被保留,该属性将被保留。 但是,如果将其设置为Setting元素的子元素,则会将其删除。

做到了。 我还不确定是否有更好的方法,但我在Sandcastle HFB项目中添加了一个SettingsDoc.xml。 缺点是它不会被visual studio编译,所以我需要自己更新和检查引用等。