C#编程规范

模块类注释

1.模块开始必须以以下格式编写模块注释:

///<summary>
///模块编号:<模块编号,可以引用系统设计中的模块编号>
///作用:<对此类的描述,可以引用系统设计中的描述>
///作者:作者中文名
///编写日期:<模块创建日期,格式:YYYY-MM-DD>
///</summary>

2.如果模块有修改,则每次修改必须添加以下注释:

///<summary>
///Log编号:<Log编号,从1开始每次+1>
///修改描述:<对此修改的描述>
///作者:修改者中文名
///修改日期:<模块修改日期,格式:YYYY-MM-DD>
///</summary>

3.类属性注释规范

在类的属性前必须以以下格式编写属性注释:
///<summary>
///属性说明
///</summary>

4.方法注释规范

在类的方法声明前必须以以下格式编写注释:
///<summary>
///说明:<对该方法的说明>
///</summary>
///<param name="<参数名称>"><参数说明></param>
///<returns>
///<对方法返回值的说明,该说明必须明确说明返回的值代表什么含义>
///</returns>

5.代码间注释规范

//<单行注释>
/*
多行注释1
多行注释2
多行注释3
*/

posted on 2012-03-20 21:20  YeChun  阅读(212)  评论(0编辑  收藏  举报

导航