标签：.net interface vb.net class 注释
随着学习的不断深入，我们也正在逐步触摸到职业化的门槛，就拿注释来说，良好的注释说明在职业化编程中是非常必要的，因为这有助于他人对程序的阅读理解，使小组之间交流起来更加便利。
这几天在编写重构机房收费系统，里面当然少不了注释，但是我对其中的一种注释却非常的头疼—文件头注释。因为头注释里面的内容多，而且每个类或窗体里面的头注释内容大多相似，所以每次新建一个类或窗体的时候都要复制粘贴（当然还得稍微修改一下）。每次做这些重复的事情让我感到很无奈，所以就想到是不是有种方法可以让VS自动生成头注释呢？在网上一搜索就查询到了很多关于头注释编辑的文章，果然有很多大牛们都想到了这种情况，并且还提供了解决的方法。
在这里给大家做一个详细的说明：
头文件注释的要求：
注释中必须添加的内容有：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。
类头注释的模版：
（仅供参考）
‘**********************************************
‘ 文 件 名：$safeitemname$
‘ 命名空间：$rootnamespace$
‘ 内 容：
‘ 功 能：
‘ 文件关系：
‘ 作 者：XXX
‘ 小 组：XX
‘ 生成日期：$time$
‘ 版 本 号：V1.0.0.0
‘ 修改日志：
‘ 版权说明：
‘**********************************************
如何添加模版：
（以我为例）
1. 打开VS2013的安装目录 D:\应用软件\Visual Studio 2013
2. 找到Common7文件夹，接着打开 Common7\IDE\ItemTemplatesCache
3. 在这里我们会看到VisualBasic文件夹，依次打开 VisualBasic\Code\2052\Class ，找到Class.vb文件并且以记事本方式打开，在其中加入以上的模版保存，如下图：
然后打开VS2013，新建一个类试一下效果：果然，新建类时VS就会自动生成 头文件注释了。
4. 在VisualBasic\Code\2052这个目录下还有Interface ，WebClass 等文件夹，没错修改其中相应的.vb文件，添加上述模版，效果图：接口的头注释已经自动添加。
5.现阶段大家做的系统有很多From窗体，可是在VisualBasic\WindowsForms\2052里并没有From这个文件夹，那么From的注释模版该怎么添加呢？
打开步骤三中的文件夹VisualBasic，找到\VisualBasic\WindowsForms\2052\Form，找到From.vb文件并按照上述方法修改即可。
另外：在D:\应用软件\VisualStudio 2013\Common7\IDE\ItemTemplatesCache目录下不仅仅有VisualBasic，还有CSharp、JavaScript等语言，上述方法同样适用！
$safeitemname$、$rootnamespace$ ？？
这些参数都是系统变量，功能类似于Foxmail模版里面的宏。
其他可用的参数有：（需要注意：这些参数区分大小写！）
磨刀不误砍柴工，这些积累将来都会是我们提高工作效率的筹码！
头文件注释轻松搞—VS2013,布布扣,bubuko.com
标签：.net interface vb.net class 注释
原文地址：http://blog.csdn.net/u010028869/article/details/26454197
