分享
 
 
 

vb.net 程序设计规范(1)

王朝vb·作者佚名  2006-01-09
窄屏简体版  字體: |||超大  

引言:Kent Beck 曾经说过“我只是个更注重的程序规范的程序员而已”

目录:

前言

说明性文件规范

过程注释的规范

函数的注释规范

命名规范

设计规范:

前言: 1.设计规范的重要性:理由N多, 不在多述

2. 本文适用性 :vb.net 开发 asp.net 开发

注释代码的目标:

1. 叙述清除]代码的作用(是做什么,而不是怎么做)

2. 清楚说明代码所要表达的思想和逻辑

3. 表明代码中的重要转折点

4. 减少代码阅读者在他们大脑中模拟代码的运行

注意:注视应该说明代码的目的,而不要去叙述怎么完成目标的结构,要讲清为什么要那么做,而不是怎么去做

用特殊字符标识注释的作者: ‘$ ‘@ 开头的行 分别代表不同人写的注释代码

一. 说明性文件规范(写在每个.vb结尾的文件头,说明整个文件的功能)

1.1 以’----------------------------------开始和结尾

1.2 File name: 文件名

1.3 Author作者 Version版本: Date及完成日期:

1.4 Description: 用于详细说明此程序文件完成的主要功能,与其他模块

或函数的接口,输出值、取值范围、含义及参数间的控

制、顺序、独立或依赖等关系

1.5 Others: 其它内容的说明

1.6 Function List: 主要函数列表,每条记录应包括函数名及功能简要说明

1.7 History: 修改历史记录列表,每条修改记录应包括修改日期、修改

者及修改内容简述

1. Date:

Author:

Modification:

2.。。。。。。。。。。。

二. 过程注释的规范

2.1 以’----------------------------------开始和结尾

2.2 Description: 功能描述

2.3 Parameters :参数说明

2.4 Calls : 被本过程调用的函数或过程

2.5 Called By: 调用本过程的函数清单

2.6 Table Accessed: 被访问的表(此项仅对于牵扯到数据库操作的程序)

2.7 Table Updated: 被修改的表(此项仅对于牵扯到数据库操作的程序)

三.函数的注释规范

3.1 Function: 函数名称

3.2 Description: 函数功能、性能等的描述

3.3 Calls: 被本函数调用的函数清单

3.4 Called By: 调用本函数的函数清单

3.5Table Accessed: // 被访问的表(此项仅对于牵扯到数据库操作的程序)

3.6 Table Updated: // 被修改的表(此项仅对于牵扯到数据库操作的程序)

3.7 Parameters: // 输入参数说明,包括每个参数的作

// 用、取值说明及参数间关系。

3.8 Return: // 函数返回值的说明

四 命名规范

4. 1件命名规范

(1)普通控件

名称 前缀 示例

adrotator adrt adrtTopad

button btn btnSubmit

calendar cal calMeetingDates

CheckBox chk chkBlue

CheckBoxList chkl chkFavcolors

CompareValidator valc valcValidAge

CustomValidator valx valxDbcheck

DataGrid dgrd dgrdTitles

DataList dlst dlstTiltles

DriopDownList Drop drop

Hyperlink link lnkDetails

Image img imgAuntBetty

ImageButton Ibtn ibtnSubmit

Label lbl lblResults

LinkButton lbtn

ListBox lst

Panel pnl

RadioButton rad

RadopButtonList radl

RangeValidator valg

Regularexpression vale

Repeater rpt

RequiredFieldValidator valr

Table tbl

TableCell tblc

TableRow tblr

TextBox txt

Validationsummary vals

Xml xmlc

(2) ado.net 控件命名

connction con conNorthwind(con +数据库名称)

command cmd cmdReturnProducts

Parameter parm parmProductId

DataAdapter dad dadProducts

DataReader dtr dtrProducts

DataSet dst dstNorthwind

DataTable dtbl dtblPrpducts

DataRow drow drowRow98

DataColumn dcol dcolProductId

DataRelation drel drelMasterDetaril

Dataview dvw dvwfilteredProducts

(3)变量命名的目标:

1. 使变量的用途明确

2. 使每个变量的数据类型和可见范围清晰明了

3. 使代码中的过程易于理解

4. 使程序易于调试

5. 使变量的存储和处理更为有效

其余见vb.net 程序设计规范(2)

 
 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
2023年上半年GDP全球前十五强
 百态   2023-10-24
美众议院议长启动对拜登的弹劾调查
 百态   2023-09-13
上海、济南、武汉等多地出现不明坠落物
 探索   2023-09-06
印度或要将国名改为“巴拉特”
 百态   2023-09-06
男子为女友送行,买票不登机被捕
 百态   2023-08-20
手机地震预警功能怎么开?
 干货   2023-08-06
女子4年卖2套房花700多万做美容:不但没变美脸,面部还出现变形
 百态   2023-08-04
住户一楼被水淹 还冲来8头猪
 百态   2023-07-31
女子体内爬出大量瓜子状活虫
 百态   2023-07-25
地球连续35年收到神秘规律性信号,网友:不要回答!
 探索   2023-07-21
全球镓价格本周大涨27%
 探索   2023-07-09
钱都流向了那些不缺钱的人,苦都留给了能吃苦的人
 探索   2023-07-02
倩女手游刀客魅者强控制(强混乱强眩晕强睡眠)和对应控制抗性的关系
 百态   2020-08-20
美国5月9日最新疫情:美国确诊人数突破131万
 百态   2020-05-09
荷兰政府宣布将集体辞职
 干货   2020-04-30
倩女幽魂手游师徒任务情义春秋猜成语答案逍遥观:鹏程万里
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案神机营:射石饮羽
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案昆仑山:拔刀相助
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案天工阁:鬼斧神工
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案丝路古道:单枪匹马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:与虎谋皮
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:李代桃僵
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:指鹿为马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:小鸟依人
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:千金买邻
 干货   2019-11-12
 
推荐阅读
 
 
 
>>返回首頁<<
 
靜靜地坐在廢墟上,四周的荒凉一望無際,忽然覺得,淒涼也很美
© 2005- 王朝網路 版權所有