在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编译,所以我需要自己更新和检查引用等。