一聚教程网:一个值得你收藏的教程网站

热门教程

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

时间:2022-07-02 11:19:36 编辑:袖梨 来源:一聚教程网

引言: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: 功能描述

热门栏目