《dotnet项目组编码规范》由会员分享，可在线阅读，更多相关《dotnet项目组编码规范（10页珍藏版）》请在金锄头文库上搜索。
1、一程序代码的注释1存储过程的头部注释每一个存储过程都要写注释，写在最前面。如/*Author： BillCreate Time： 2003-06-16 17:04Last Modify Time： 2003-06-16 17:13Version： 1.0.01Action describe： Memo： */2存储过程的代码内部注释存储过程的内部需要视情况添加注释，简单说明其功能、设计思想、算法等等。如：/* SET NOCOUNT ON */3 CS文件的头部注释每一个.CS文件都要写注释，写在CS文件的最前面。如/*File Name（文件名）： ClientServiceS.csStor
2、age Path（存储路径）： Capitalnet_MISEntityDAOAuthor（作者）： BillCreate Time（建立日期及时间）： 2003-06-16 17:04Last Modify Time（最后修改日期及时间）： 2003-06-16 17:13File Version（本文件版本号）：X.X.XXX 1.0.01File Action describe（文件功能描述）：客户服务实体访问层File Memo（备注）：*/4类的注释为你定义的类写详细的注释，包括作者、时间、版本修订信息、基本的算法，如：/ / 类的简单描述/ 5类成员的注释每一个类的成员，如变量、属
3、性等都要加相应的注释。6方法的注释为你定义的每一个函数写详细的注释，包括输入输出参数说明、返回值说明、函数功能说明：/ / 取得本帐期的帐单/ / 合同Guid/ 本帐期日期/ 帐单列表public static ContractPaidListData CalculateThisPaid(string contractGuid,DateTime date) 7代码内部的注释关键代码必须加注释，简单说明其功能、设计思想、算法等等。长条注释（划分功能模块）、短条注释（说明实现的各步骤）与句后解释（说明重要句的意义）相结合，清晰功能的实现层次。如：/ Draw the string as norm
4、al and let then transforms do the work/* This is a test*/1) 一般来讲，按需要来注释，简明扼要。2) 修改代码的注释，当有第二人开始修改代码时，应在每一次修改的代码部分加以注释，必须包括修改人，修改时间，还可以包括修改目的等。8 其他要点1) 对上述较长者在范围结束处加注释。如/for 循环结束。2) 注释必须简明扼要，规范易懂。二对象的可访问性设计1) 不要随意定义类的public，这在基于组件的开发中相当重要。2) 只有被其他类引用的函数才定义成public型函数。3) 类中最好不用public型成员变量（一般使用属性来代替）。4)
5、 最好不使用全局变量。可以使用一些代替的方法。三对象的命名规范1 命名要求1) 所有命名（类、函数、变量.）均要求意义明确易于理解。2) 避免在代码中直接使用数字等不确定意义的词，尽量使用有意义的串值代替。例子：Protected Const string CAPTION_TITLE= Bind Data to a ComboBox3) 在名字上区分各种变量及函数。2命名约定1) 常量命名规则。一般用大写具有意义的复合单词来定义。protected Const string CAPTION_TITLE= Bind Data to a ComboBox2) 字段（变量），开头将一小写字母开头，后
6、面的具有意义的英语单词开始于大写。public string strName等3) 属性，一般用大写字母开头，要具有一定的意义。Name;4) 类名，以大写字母开头的有意义的复合英语单词。对类名的定义还要考虑到该类的意义。比如我们在项目中分了商务规则层、数据层、商务界面层、数据访问层等。我在下面给出一个Agent表在各层中进行处理的时候相关的类的命名：AgentData-AgentS-AgentR-AgentF(分别是：数据实体、数据访问层、商务规则层、商务界面层的命名)5) 控件的命名规则，控件的命名可以以控件的缩写开头（小写），配以一定意义的英文单词；尽量让缩写可以理解。遇到新的控件可以大
7、家讨论来制定。比如：Button：btnUpateDropDownList: ddlstCityLabel: lblNameDataGrid : grdAgentDataList : dlstAgentTextBox : txtName(等等) 6) 文件名字的命名，以大写字母开头。DataAccess.cs四数据表的定义和功能描述1) 基础表的定义基础表是指与业务无直接关系，仅为业务实现提供基础数据的数据库表。这类表有国家（Country）、货币（Currency）、单位（Company）、联系人(Contact)、产品（Product）、银行（Bank）等等。2) 基础表提供的维护功能对这
8、些基础表要提供添加、修改、删除、查看等等维护功能。在这些功能中，查看功能是很重要的，要给出多个条件的查看功能的方法，以便别的功能模块的查看和引用的需要。3) 业务表的定义业务表则是指与业务直接相关，用以保存各项业务数据、实现各项业务功能的数据库表，这类表有合同（Contract）、项目（Project）、机会（Opportunity）、合同费用（ContractPaidList）等等。4) 业务表提供的维护功能对这些业务表要提供添加、修改、删除、查看等等维护功能。因为这些数据与业务息息相关，故要能给出多种查询的方法。这些业务会涉及到大量的业务逻辑，故需使用业务逻辑层对业务表中的数据进行处理。五
9、项目的分层定义和编码规范1数据实体层的定义和编码规范这一层主要定义类型化数据集的XML架构(XSD)。是数据库的内存表示，建立架构后代码由系统自动生成。1) 添加数据集：添加添加新项数据集；2) 定义数据表架构：(1) 单表形式：从“服务器资源管理器”中将单表拖至设计界面，系统将自动生成表结构；(2) 多表形式：方法一.照上述方法生成多个表，然后手工添加表间关联（如果有的话）;方法二.照上述方法生成基本表，然后手工添加其他相关字段，组成一张表；而他的XML格式这是这样的：2 SQL层的定义和编码规范这一层定义用于与数据库交互的SQL语句。这一层负责生成用于操作数据库的SQL语句。根据要操作的数
10、据实体层来分别的定义这一层要实现的方法，在本项目组中，我们一般只需要定义选择查询所需要的SQL语句。这里的方法中所做的工作全部是拼装出一个用于实现所需求的功能的SQL语句。如：public static string strGetLogonLog = SELECT LogonLog.* FROM LogonLog;public static string GetLogonLogByUserName(string userName)return strGetLogonLog + WHERE (UserName = N +userName+ );3数据访问层的定义和编码规范这一层负责操作数据库。这
11、一层负责对数据库进行各种操作。根据要操作的数据实体层来分别的定义这一层要实现的方法，在本系统中，一般要包括读取数据的方法和将数据更新回数据库的方法。在这一层向上，数据将可能有两个流向：如果本模块有商务规则，数据将流向商务规则层；如果本模块没有商务规则，则数据将流向商务界面层。编码示例如下：public MenuData GetMenu() MenuData ds = new MenuData();DatabaseExecute dbExec = new DatabaseExecute();dbExec.GetData(ds.Menu,MenuSQL.strGetMenu);return ds;public void UpdateMenu(MenuData ds)DataTableExtend dt = new DataTableExtend(ds.Menu,Menu);DatabaseExecute dbExec = new DatabaseExecute();dbExec.ModifyDataBase(dt);4
