c#代码编写规范说明书

c#代码编写规范说明书

ID:6071070

大小:65.50 KB

页数:13页

时间:2018-01-02

c#代码编写规范说明书_第1页
c#代码编写规范说明书_第2页
c#代码编写规范说明书_第3页
c#代码编写规范说明书_第4页
c#代码编写规范说明书_第5页
资源描述:

《c#代码编写规范说明书》由会员上传分享,免费在线阅读,更多相关内容在行业资料-天天文库

1、目录1目的 2范围3注释规范  3.1概述  3.2自建代码文件注释  3.3模块(类)注释  3.4类属性注释  3.5方法注释  3.6代码间注释4命名总体规则5命名规范  5.1变量(Variable)命名  5.2常量命名  5.3类(Class)命名  5.4接口(Interface)命名  5.5方法(Method)命名  5.6名称空间Namespace)命名6编码规则  6.1错误检查规则  6.2大括号规则  6.3缩进规则  6.4小括号规则  6.5IfThenElse规则  6.6比较规则  6.7Case规则  6.8对齐规则  6.9单语句规则  6.10单一功

2、能规则  6.11简单功能规则  6.12明确条件规则  6.13选用FALSE规则  6.14独立赋值规则  6.15定义常量规则  6.16模块化规则  6.17交流规则7编程准则  7.1变量使用  7.2数据库操作  7.3对象使用  7.4模块设计原则  7.5结构化要求  7.6函数返回值原则8代码包规范  8.1代码包的版本号  8.2代码包的标识  9代码的控制  9.1代码库/目录的建立  9.2代码归档10输入控制校验规则  10.1登陆控制  10.2数据录入控制附件1:数据类型缩写表附件2:服务器控件名缩写表1目的一.为了统一公司软件开发设计过程的编程规范二.使网站

3、开发人员能很方便的理解每个目录,变量,控件,类,方法的意义三.为了保证编写出的程序都符合相同的规范,保证一致性、统一性而建立的程序编码规范。四.编码规范和约定必须能明显改善代码可读性,并有助于代码管理、分类范围适用于企业所有基于.NET平台的软件开发工作2范围本规范适用于开发组全体人员,作用于软件项目开发的代码编写阶段和后期维护阶段。3注释规范3.1概述a)注释中,应标明对象的完整的名称及其用途,但应避免对代码过于详细的描述。b)编码的同时书写注释。c)重要变量必须有注释。d)典型算法必须有注释。e)在循环和逻辑分支地方的上行必须就近书写注释。f)程序段或语句的注释在程序段或语句的上一行g

4、)在代码交付之前,必须删掉临时的或无关的注释。3.2自建代码文件注释对于自己创建的代码文件(如函数、脚本),在文件开头,一般编写如下注释:/******************************************************FileName:Copyright(c)2004-xxxx*********公司技术开发部Author:createDate:******************************************************/3.3模块(类)注释模块开始必须以以下形式书写模块注释:///

///Depiction:<对

5、此类的描述,可以引用系统设计中的描述>///Author:作者中文名///CreateDate:<模块创建日期,格式:YYYY-MM-DD>///

如果模块只进行部分少量代码的修改时,则每次修改须添加以下注释:///RewriterRewriteDate:<修改日期:格式YYYY-MM-DD>Start1:/*原代码内容*////End1:将原代码内容注释掉,然后添加新代码使用以下注释:///AddedbyAdddate:<添加日期,格式:YYYY-MM-DD>Start2:///End2: 如果模块输入输出参数或功能结构有较大修改,则每次修改必须添加以下注释:///

6、ummary>///LogID:///depiction:<对此修改的描述>///Author:修改者中文名///RewriteDate:<模块修改日期,格式:YYYY-MM-DD>///3.4类属性注释在类的属性必须以以下格式编写属性注释:///

//////3.5方法注释在类的方法声明前必须以以下格式编写注释//////depiction:<对该方法的说明>//////"><参数说明>

7、//////<对方法返回值的说明,该说明必须明确说明返回的值代表什么含义>//////Writer:作者中文名///CreateDate:<方法创建日期,格式:YYYY-MM-DD>3.6代码间注释代码间注释分为单行注释和多行注释://<单行注释>/*多行注释1多行注释2多行注释3*/代码中遇到语句块时必须添加注释(if,for,foreach,……),添加的注释必须

当前文档最多预览五页,下载文档查看全文

此文档下载收益归作者所有

当前文档最多预览五页,下载文档查看全文
温馨提示:
1. 部分包含数学公式或PPT动画的文件,查看预览时可能会显示错乱或异常,文件下载后无此问题,请放心下载。
2. 本文档由用户上传,版权归属用户,天天文库负责整理代发布。如果您对本文档版权有争议请及时联系客服。
3. 下载前请仔细阅读文档内容,确认文档内容符合您的需求后进行下载,若出现内容与标题不符可向本站投诉处理。
4. 下载文档时可能由于网络波动等原因无法下载或下载错误,付费完成后未能成功下载的用户请联系客服处理。