Visual Basic编程规范Word格式文档下载.docx
- 文档编号:21828385
- 上传时间:2023-02-01
- 格式:DOCX
- 页数:14
- 大小:23.74KB
Visual Basic编程规范Word格式文档下载.docx
《Visual Basic编程规范Word格式文档下载.docx》由会员分享,可在线阅读,更多相关《Visual Basic编程规范Word格式文档下载.docx(14页珍藏版)》请在冰豆网上搜索。
xwy….lib。
工程命名不必缩写,为了表达意思和用途,可以尽可能地长,而且命名格式采用(名词)、(形容词+名词)或(名词+动作的名词形式)。
如:
stockoperationlib或stocklib。
2.2变量的命名
程序中的变量遵循匈牙利表示法,即“前缀+变量含义”,变量的含义为一个或多个英文单词(Pascal大小写),每个单词的第一个字母大写。
变量前缀为三个小写字母示意其类型,所需添加的前缀遵循微软在msdn中的建议。
列表如下:
对于一般的计数器变量定义,应该尽可能地简单,如:
dimiasinteger
fori=0to100
nexti
范围标识:
全局变量加前缀:
’g_’例如:
g_strFdbm
模块级变量加前缀:
’m_’例如:
m_strFdbm
过程级变量不加前缀
全局变量和模块级变量应该尽量使用全名称,不推荐使用缩写,如:
g_EntityManager
在适当的时候,使用众所周知的缩写替换冗长的词组名称,在使用缩写时,对于超过两个字符长度的缩写请使用Pascal大小写。
例如,使用HtmlButton。
但是,应当大写仅有两个字符的缩写,如,System.IO,而不是System.Io。
常见的变量类型和控件类型前缀如下表所示:
变量类型前缀列表
数据类型
前缀
示例
boolean
bln
blnLoggedin
currency
cur
curSalary
control
ctl
ctlLastcontrol
double
dbl
dblMiles
errobject
err
errLastError
single
sng
sngYears
handle
hwd
hwdPicture
long
lng
lngOnhand
object
obj
objUserTable
integer
int
intAge
string
str
strName
user-definedtype
udt
udtEmployee
variant(includingdates)
vnt
vntDateHired
array
arr
arrEmployees
数据库对象
database
dbs
dbsAccounts
recordset
rec
recForecast
command
cmd
cmdQuery
connection
con
conSql
控件的命名
控件命名一律使用控件类型缩写+控件用途的命名方式,缩写规则同变量命名,以下是常用控件的类型缩写,应该严格遵守。
如果使用了新的控件(包括升级版本),必须向公司提出申请,经评审通过后,协同一致其类型名称缩写,再进行使用。
控件类型前缀列表
控件
举例
adodata
ado
adoBiblio
animatedbutton
ani
aniMailbox
checkbox
chk
chkPrint
combobox
cbo
cboTitle
commandbutton
cmdCancel
communications
com
comFax
data
dat
datBiblio
data-boundcombobox
dbcbo
dbcBolanguage
data-boundgrid
dbgrd
dbgRdqueryResult
commondialogcontrol
dlg
dlgCommon
ctr
ctrCurrent
directorylistbox
dir
dirSource
drivelistbox
drv
drvTarget
dtpicker
dropdatecontrol
dt
enumeditbox
enm
filelistbox
fil
filSource
frame
fra
fraLanguage
form
frm
frmMain
vfgrid
grd
graph
gra
grouppushbutton
gpb
gpbChannel
hierarchicalflexgrid
flex
flexOrders
horizontalscrollbar
hsb
hsbVolume
image
img
imgIcon
imageimagelist
label
lbl
lblHelpMessage
line
lin
linVertical
listbox
lst
lstResultCodes
listview
lv
mci
mciVideo
mdichildform
mdi
mdiContact
menucontrol
mnu
mnuFileopen
numeditbox
nm
olecontainer
ole
olePhoto
optionbutton
opt
optSpanish
panel
pnl
pnlSettings
picturebox
pic
picDiskSpace
pictureclip
clp
clpToolbar
progressbar
prg
prgLoadfile
report
rpt
scrollbar
sbr
shape
shp
shpCircle
slider
sld
sldScale
spin
spn
statusbar
st
toolbar
tb
textbox
txt
txtAddress
timer
tmr
tmrAlarm
treeview
tv
tvFlbm
verticalscrollbar
vsb
vsbRate
2.4函数和过程的命名
此处函数包括sub和function,以下这两种过程统称为函数。
函数表示的是一个动作,所以它的结构应该是动词+名词,动词必须小写,后面的名称首字母大写,如:
getMaterialCodeupdateGridreadOrder
函数命名尽量不要使用缩写,而且它的名称应该使人一目了然,能够从名称就知道这个函数的功能,不要使用无意义的函数名称,如:
getCode,update,readData。
当函数名称不足以表达其功能时,使用在函数头部加上让调用者足够明白的注释。
参数的命名:
参数命名的原则是全部小写,如果参数包括两个或以上的单词时,首单词字母小写,其它单词首字母大写,如showCol、isUpdate。
2.5常量的命名
常量的命名应该全部大写,使用‘_’作为单词间的分隔符,单词尽量使用全名称,如:
publicconstMSG_EMPTY_ROWasstring=“有空行存在!
”
解释:
(1)
对一些常用词应该使用简写,如msg
(2)
使用public来声明常量
(3)
对常量的声明必须带上类型,如上面的asstring
2.6属性的命名
属性的命名采用首字母大写的原则,如ItemCount
2.7类、窗体和模块的命名
类的命名:
cls前缀+功能名词,并且单词首字母大写。
clsSystemConfig
窗体命名:
使用frm前缀+功能名词,并且单词首字母大写。
frmList。
模块命名:
mod前缀+功能名词,并且单词首字母大写。
如modList。
以上三种命名在一个项目内必须保持唯一。
2.8自定义控件的命名
自定义控件的命名:
名词+ctrl如:
EditGridctrl
书写格式约定
3.1定义
定义的代码块应该放在一起,不要在中间定义变量,变量的定义应该顶行进齐,不能缩进。
如下:
dimjasinteger
dimemasEntityManager
对象的定义应该尽可能地带上所属的库名称,防止以后引起名称冲突,如引用了两个lib,每个中都包含一个stock类,如果不使用as….lib.stock的定义方式,则无法编译通过,为了防止以后程序扩充和修改时引入新的库带来命名冲突,推荐在定义类对象时全部加上库标识,如:
dimemasobjectpersistencelib.EntityManager
3.2空行
空行是区分代码块与块的间隔,在函数之间必须加上空行(两行左右),而函数内部,变量声明块和实现块(实现块指除变量声明外的其它代码)要使用空行来间隔(一行),实现块的内部,通过空行来标识一个功能段,如:
privatesubcheckItem(orderasnysalebacklib.order)
dimobjStockItemasnystocklib.stockitem
dimobjStockasnystocklib.stock
setobjStock=createStock()
fori=0toorder.ItemCount-1
setobjStockItem=order.Item(i)
//减少库存
callobjStock.reduceItem(objStockItem,true)
nexti
setobjStock=nothing
endsub
(注意:
不要使用过多的空行,空行太多影响代码阅读!
)
3.3缩进
缩进必须严格执行,变量声明块不缩进,实现块必须保证全部缩进(即不可能有实现块是行首对齐的)。
每个单位的代码缩进为一个tab,非相关代码留一行空白的间隔。
注:
goto标签不缩进
对于基本的控制结构,必须要有缩进,如:
if、do、with、for、open、select块,缩进示例如下:
privatefunctiongetMax(byreflngArray()aslong)aslong
dimlngMaxaslong
dimlngCountaslong
getMax=0
forlngCount=0toubound(lngArray)
iflngArray(lngVount)>
lngMaxthen
lngMax=lngArray(lngCount)
endif
next
endfunction
对于过长的语句,必须使用续行,续行位置要有明显意义,示例:
sql=“select[code],[name]from[person]“_
&
“where[code]like‘001%’“_
“and[code]like‘002%’“
函数的参数如果过长,也应该续行,示例:
增加库存
productCode产品编号
spec长度规格
color颜色
patch是否拼圈
volumn盘号
ordinal子库存顺序号
length长度
ischeck是否审核入库增加(否则为弃审出库增加)
publicsubaddDetail(productCodeasstring,_
specasdouble,_
colorasstring,_
patchasboolean,_
volumnasstring,_
ordinalasinteger,_
lengthasdouble,_
ischeckasboolean)
4.注释约定
4.1注释量
程序的注译越详尽,越仔细越好。
程序中声明的每一个变量,能加上注译最好,至少用来运算或者保存关键数据的变量必须加上注译。
对于每一段逻辑上实现某个基本功能的几句代码,最好在其上一行加上简单注译。
对于每一个自定义的函数,不管大小都必须加上注译。
4.2格式
注译的格式如下:
******************************************************
函数所实现的功能
函数的参数1的含义:
xxxxx
函数的参数2的含义:
……
函数返回值所代表的错误信息:
xxxxx
函数的返回值为0表示执行成功,为其它值表示执行失败
******************************************************
public(private)functionforExample(……………………)aslong
…………………………………………
endfunction
在每个代码模块(窗体、类、模块、控件)的最上面,必须写上代码编写人、代码创建时间、代码修改时间和修改说明。
示例:
库存修改窗体
作者
xxxxxx
建立日期
2005-6-22
修改日期
2005-6-23修改人xxxxxx
增加对库存修改时同时影响最后入库日期的功能
5.程序设计约定
即ifapp.previnstance=truethenend
这样做可以减少一些数据溢出的错误,而且,在win32位平台上,cpu处理32位的数据比16位的数据速度更快。
下面例子用+运算符来连接可能会导致问题。
例如:
vntvar1="
10.01"
vntvar2=11
vntresult=vntvar1+vntvar2vntresult=21.01
vntresult=vntvar1&
vntvar2vntresult=10.0111
当显示一个消息框(msgbox)或输入框(inputbox),或产生一个sql字符串时,这一技术特别有用。
dimmsgasstring
msg="
thisisaparagraphthatwillbe"
_
&
"
inamessagebox.thetextis"
"
brokenintoseverallinesofcode"
inthesourcecode,makingiteasier"
fortheprogrammertoreadanddebug."
msgboxmsg
dimqryasstring
qry="
select*"
fromtitles"
where[yearpublished]>
1988"
titlesqry.sql=qry
cbool(expression)
cbyte(expression)
ccur(expression)
cdate(expression)
cdbl(expression)
cdec(expression)
cint(expression)
clng(expression)
csng(expression)
cstr(expression)
cvar(expression)
val(expression)
5.8错误处理(编一个函数处理所有已知错误)
在main()函数或主窗体load过程中添加如下代码:
打开错误日志文件,在form_unload()中关闭
******************************************************
dimstrExePathasstring
ifright(app.path,1)="
\"
then
strExePath=app.path
else
strExePath=app.path&
endif
intErrLogfileHandle=freefile()
openstrExePath+"
err.log"
forappendsharedasintErrLogfileHandle
在主窗体退出函数中添加如下代码:
关闭错误日志文件
close#interrlogfilehandle
在某个module中添加:
写入错误日志
publicsubwriteErrLogfile(byvalstrsubasstring,byvalstrerrasstring)
print#intErrLogfileHandle,date,time,strsub,strerr
endsub
在每个过程或自定义的函数中,使用如下的系统错误捕获机制:
publicfunctionforExample(…………)aslong
onerrorgotofuncerror
forExample=true
………………………
exitfunction
funcerror:
forExample=false
writeErrLogfile"
forExample"
"
错误号:
err.number&
,错误源:
err.source&
,错误描述:
err.description
msgbox
………"
vbcritical
在此作内存资源回收工作
5.9窗体布局
窗体内各个控件的布局,建议如下:
1、所有与窗体上、下、左、右四条边界相邻的控件与窗体的边缘相距120缇
2、各个控件之间的间距为:
相关控件60缇,非相关控件120缇
3、按钮控件大小为高300缇,长〉=1200缇,这也是操作系统默认按钮的大小
4、各个控件的字体建议为宋体五号字(考虑到我公司使用的是触摸屏,可以更改为宋体4号字)
程序结构清晰,简单易懂,单个函数的程序行数不得超过100行。
避免使用大
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- Visual Basic编程规范 Basic 编程 规范