C#语言开发规范-ching版
拙劣之处请大家斧正,愚某虚心接受,如有雷同,不胜荣幸
C#语言开发规范
作者ching
1. 命名规范
a) 类
【规则1-1】使用Pascal规则命名类名,即首字母要大写。
eg:
Class Test
{
...
}
【规则1-2】使用能够反映类功能的名词或名词短语命名类。
【规则1-3】不要使用“I”、“C”、“_”等特定含义前缀(I前缀用来定义接口等等)。
【规则1-4】自定义异常类应以Exception结尾。
eg:
Class TestException
{
...
}
【规则1-5】文件名要能反映类的内容,最好是和类同名。
b) 类字段(类成员)
【规则2-1】用camel规则来命名类成员变量名称,即首单词(或单词缩写)小写。
【规则2-2】类字段变量名前可加“_”前缀。
【规则2-3】坚决禁止在普通变量前加“m_”(这是VC老命名规则)。
eg:
Class Test
{
private string myName;
private string _myCoCo;
...
}
c)方法
【规则3-1】方法名采用Pascal规则,第一个字符要大写。
【规则3-2】方法名应使用动词或动词短语。
【规则3-3】类中访问修饰符或功能相同的方法应该放在一起, 且公共或实现接口的方法在前。
eg:
Class Test
{
...
public void GetData(...)
{
...
}
private void GetName(...)
{
...
}
private static void GetCount(...)
{
...
}
}
d)属性
【规则4-1】使用名词定义属性,属性使用Pascal规则,首字符大写
【规则4-2】属性和相应字段名称要关联, 可以使用“重构”菜单来生成属性。
eg:
Class Test
{
private string myName;
public string MyName
{
set
{
myName = Value;
}
get
{
return myName;
}
}
}
e)参数
【规则5-1】参数采用camel规则命名,且首字符小写。
【规则5-2】使用描述性参数名称,参数名称应当具有最够的说明性。
【规则5-3】不要给参数加匈牙利语类型表示法的前缀。
【规则5-4】检查方法所有输入参数的有效性。
eg:
Class Test
{
public void GetData(string name,string strFlag)
{
...
}
}
f)常量
【规则6-1】只读常量使用Pascal命名规则,即首字母大写。
【规则6-2】枚举名使用Pascal规则命名,枚举成员本质属于常量,命名规则同上。
【规则6-3】枚举值从小到大顺序定义。
【规则6-4】静态字段或属性采用Pascal规则,即首字符大写。
eg:
Class Test
{
public const double Pi = 3.14159365753;
private readonly double Pai = 3.14159365753;
}
g)接口
【规则7-1】接口定义使用Pascal规则,且必须以大写“I”开头。
【规则7-2】接口名称要有意义,中间不要有下划线“_”等字符。
【规则7-3】如果类实现了接口,名称尽量和接口相同, 只是省掉“I”字符。
eg:注意这里的接口修饰符只能用public和internal
interface ITest
{
...
}
h)事件
【规则8-1】委托名称采用Pascal规则,即首字符大写。
【规则8-2】定义事件的委托要使用EventHandler后缀,且包括sender和e两个参数。
【规则8-3】事件用到的参数,名称要带EventArgs后缀。
eg:
Class Test
{
private delegate void DoTask();
private event DoTask DoTaskEventHandler;
private event DoTask DoTaskEventHandler(Object sender,EventArgs e);
private event DoTaskDoTaskEventHandler2(string strEventArgs)
{
...
}
...
}
i) 命名空间
【规则9-1】命名空间名称采用Pascal规则,且首字符大写。
【规则9-2】命名空间名称尽量反映其内容所提供的整体功能。
eg:
namespace MyTest
{
Class Test
{
...
}
...
}
2. 注释规范
a)文件头部注释
【规则1-1】文件都包含文件头, 要说明文件名、作者、创建时间、变更记录。
【规则1-2】推荐采用.NET形式书写头部注释。(待考查)
b)类及其成员注释
【规则2-1】对方法和类使用“///”三斜线注释。
【规则2-2】代码行文注释采用“//”和“/**/”进行,应该尽量说明问题。
3.行文规范
a)缩写规范
【规则1-1】标识符应当直观可望文知意,不提倡使用任何缩写。
【规则1-2】字符串变量推荐是用“str”或“s”开头,采用string.Empty来初始化。
【规则1-3】普通对象可以以“obj”开头。
【规则1-4】缩写可自行定义,一般取单词的前/后字符组成,以含义直观为准则。
【规则1-5】一般情况下不要让缩写破坏标识符的含义。
b)排版
【规则2-1】每行语句至少占一行,如果语句过长(超过一屏),则该语句断为两行显示。
【规则2-2】把相似的内容放在一起,比如字段、属性、方法、事件等,使用“#region--#endregion”命令分组。
【规则2-3】多个程序元素进行对等操作时, 操作符之前、之后或者前后都要加空格。
【规则2-4】每个方法的源程序行数原则上应该少于200行。(如果超过过多,则需要另写一方法)
【规则2-5】语句嵌套层次不得超过3层。
【规则2-6】避免相同的代码段在多个地方出现。(尽量避免代码重复,能复用则复用)
c)语句结构
【规则3-1】如果使用了异常结构,一定要处理异常, 一般是要写日志文件。
【规则3-2】分支语句不应该使用复杂长条件, 应该将长条件封装成方法。
【规则3-3】switch语句,case后面必须接break。
【规则3-4】禁止使用goto语句进行跳转。
【规则3-5】行文中严禁出现“魔数”,特定含义的常数必须定义成枚举或常量。
【规则3-6】不同类型的操作符混合使用时,使用括号给出优先级。
【规则3-7】不允许使用复杂的操作符组合等。
【规则3-8】循环、判断语句的程序块部分用花括号括起来, 即使只有一条语句。(return;待议)
【规则3-9】在switch语句中总是要有default字句,建议使用断言。
【规则3-10】每个类和方法完成单一的功能,不设计多用途面面俱到的类或方法。
【规则3-11】严禁使用未经初始化的变量,变量通常使用构造方法来初始。
d)代码缩进
【规则4-1】碰到大括号要换行。
【规则4-2】不允许使用Java中的括号换行规范。
e)大小写
【规则5-1】不要创建名称相同,但大小写区别的任何元素。
【规则5-2】应当大写仅有两个字符的缩写。(如果只有两个字符,则都大写)
【规则5-3】不要把易混淆的数字和字符放在一起。
【规则5-4】使用英文命名标识符。
f)重名规范
【规则6-1】不允许变量名、类名、属性名、 方法名等与系统标识符重名。(系统标识符见附表)
g)SQL编码规范
【规则7-1】SQL语句全部大写。(本人的习惯是小写,为了性能,最好是大写,我自己也得把习惯改改咯,哈哈哈)
【规则7-2】对较为复杂的SQL语句加上注释,说明其功能。
【规则7-3】连接符OR、IN、AND、以及=、<=、>=等前后加空格。
【规则7-4】使用明确的列代替 SELECT *。
h)软件架构
【规则8-1】数据库中每一张表对应一个实体类/数据传输对象(DTO)。
【规则8-2】实体类名称使用表名,也可带有Dto后缀。
【规则8-3】三层架构应当合理使用,不应生搬硬套。
【规则8-4】三层架构元素推荐使用后缀:
数据传输对象 XxxxDto
DAO工厂 XxxDAOFactory
DAO接口 IXxxxDAO
服务接口 IxxxxService
DAO的数据库实现 XxxxDAOOracle/XxxxDAOInfomix
业务逻辑 XxxxManager
i)系统
【规则9-1】使用设计模式可以提高代码质量和效率。
【规则9-2】系统输入、资源操作(如内存分配、文件及目录操作)、网络操作(如通信、调用等)、任务间的操作(如通信、调用等)时必须进行错误、超时、或则异常处理。
【规则9-3】模块的编写应有完善的测试方面的考虑。
附表
表1 各种类型命名规范总结
类型 |
命名规则 |
注意事项 |
实例 |
类或结构 |
Pascal |
首字符大写 |
HttpContext |
接口 |
Pascal |
加前缀I |
IDataAdaper |
枚举名 |
Pascal |
首字符大写 |
CommandType |
枚举值 |
Pascal |
首字符大写 |
CommandType.Text |
事件 |
Pascal |
首字符大写 |
SelectedIndexChanged |
自定义异常 |
Pascal |
加后缀Exception |
ArgumentException |
类公共字段 |
Pascal |
首字符大写 |
MaxValue(或_MaxValue) |
方法 |
Pascal |
首字符大写 |
ToString() |
命名空间 |
Pascal |
首字符大写 |
System.Xml |
属性 |
Pascal |
首字符大写 |
BackColor |
保护或私有字段 |
Camel |
首字符小写 |
myVariable |
参数 |
Camel |
首字符小写 |
cmdText |
表2 数据类型缩写规则
数据类型 |
数据类型缩写 |
标准命名实例 |
Bool |
b/is |
IsVisable |
Float |
F |
FPrice |
Double |
D |
DPrice |
Unit |
U |
UAge |
Int |
I |
INumber |
Char |
Ch |
ChCode |
Byte |
Bt |
BtImages |
String |
Str |
StrName |
Struct |
St |
StStudent |
Window |
Wnd |
WndMain |
ArrayList |
Alst |
AlstStudents |
Array |
Arr |
ArrStudents |
Hashtable |
Ht |
Htstudents |
表3 Windows控件缩写规则
控件类型 |
控件名称 |
控件类型缩写 |
实例 |
Label |
标签框 |
Lb |
LbMessage |
LinkLabel |
超链接标签框 |
Lklb |
LklbToday |
Button |
按钮 |
Btn |
BtnSave |
TextBox |
文本框 |
Txt |
TxtName |
MainMenu |
菜单栏 |
Mmnu |
MmnuFile |
CheckBox |
多选框 |
Chk |
ChkStock |
RadioButton |
单选框 |
Rbtn |
RbtnSelected |
GroupBox |
组合框 |
Gbx |
GbxMain |
PictureBox |
图片框 |
Pic |
PicImage |
Panel |
Pnl |
PnlBody |
|
DataGrid |
Dgrd |
DgrdView |
|
ListBox |
Lstb |
LstbProducts |
|
CheckedListBox |
Clst |
ClstChecked |
|
ComboBox |
组合框 |
Cmb |
CmbMenu |
ListView |
列表视图 |
Lvw |
LvwBrowser |
TreeView |
树视图 |
Tvw |
TvwType |
TabControl |
Tabctl |
TabctlSelected |
|
DateTimePicker |
Dtp |
DtpStartDate |
|
HscrollBar |
Hsb |
HsbImage |
|
VscrollBar |
Vsb |
VsbImage |
|
Timer |
Tmr |
TmrCount |
|
ImageList |
Imglst |
ImglstImage |
|
ToolBar |
工具栏 |
Tlb |
TlbManage |
StatusBar |
状态栏 |
Stb |
StbFootPrint |
OpenFileDialog |
Odlg |
OdlgFile |
|
SaveFileDialog |
Sdlg |
SdlgSave |
|
FoldBrowserDialog |
Fbdlg |
FbdlgBrowser |
|
FontDialog |
Fdlg |
FdlgFoot |
|
ColorDialog |
Cdlg |
CdlgColor |
|
PrintDialog |
Pdlg |
PdlgPrint |
表 4 数据库对象缩写规范
数据库对象 |
名称 |
简写 |
实例 |
Connection |
Conn |
ConnNorthwind |
|
Command |
Cmd |
CmdReturnProducts |
|
Parameter |
Parm |
ParmProductID |
|
DataAdapter |
Dtap |
DapProducts |
|
DataReader |
Dtr |
DtrProducts |
|
DataSet |
Ds |
DsNorthwind |
|
DataTable |
Dt |
DtProduct |
|
DataRow |
Drow |
DrowRow |
|
DataColumn |
Dcol |
DcolProductID |
|
DataRelation |
Drl |
DrlMasterDetail |
|
DataView |
Dvw |
DvwFilteredProducts |
C#语言开发规范-ching版的更多相关文章
- (转载)C#语言开发规范
1. 命名规范a) 类[规则1-1]使用Pascal规则命名类名,即首字母要大写.eg:Class Test{...}[规则1-2]使用能够反映类功能的名词或名词短语命名类.[规则1-3]不要使用“ ...
- IDL语言开发规范
一.支持的类型 1.IDL支持常见的基本类型,常量,枚举,容器,结构体,服务.不支持多态和重载,参数.返回值不能为空,各个基本类型的标识如下: bool:对应java的boolean,布尔类型(tru ...
- C#语言开发规范
1. 命名规范 a) 类 [规则1-1]使用Pascal规则命名类名,即首字母要大写. eg: Class Test { ... } [规则1-2]使用能够反映类功能的名词或名词短语命名类. [规则 ...
- 阿里官方Java代码规范标准《阿里巴巴Java开发手册 终极版 v1.3.0》
终极版 v1.3.0 2017年开春之际,阿里诚意献上重磅大礼:<阿里巴巴Java开发手册>,首次公开阿里官方Java代码规范标准.这套Java统一规范标准将有助于提高行业编码规范化水平, ...
- 【转】Android 开发规范(完结版)
摘要 1 前言 2 AS 规范 3 命名规范 4 代码样式规范 5 资源文件规范 6 版本统一规范 7 第三方库规范 8 注释规范 9 测试规范 10 其他的一些规范 1 前言 为了有利于项目维护.增 ...
- IntelliJ IDEA for Mac(Java 语言开发的集成环境)破解版安装
1.软件简介 IntelliJ IDEA 是 macOS 系统上一款 java 语言开发的集成环境,IntelliJ 在业界被公认为最好的 java 开发工具之一,尤其在智能代码助手.代码自动提 ...
- 我的公司培训讲义(1):.NET开发规范教程
这是1年多以前我在公司所做讲座的讲义,现在与园友们分享,欢迎拿去使用.一起讨论.文中有若干思考题,对园友们是小菜一碟.另有设计模式讲义一篇,随后发布.博文上了首页,感谢博客园团队推荐,也感谢所有园友的 ...
- Web前端开发规范文档(google规范)
(Xee:其实没什么规范约束,但是养成一种好习惯,何乐而不为?) 区分大小写 xhtml 区分大小写,xhtml要求 标签名 属性名 值都要小写,并且要有双引号和 标签闭合. css 元素名称以及i ...
- 第八篇 :微信公众平台开发实战Java版之如何网页授权获取用户基本信息
第一部分:微信授权获取基本信息的介绍 我们首先来看看官方的文档怎么说: 如果用户在微信客户端中访问第三方网页,公众号可以通过微信网页授权机制,来获取用户基本信息,进而实现业务逻辑. 关于网页授权回调域 ...
随机推荐
- openwrt 编译 gmediarender
output_gstreamer.o: In function `my_bus_callback': output_gstreamer.c:(.text+0xf68): undefined refer ...
- Direct3D 9 入门样例程序 圆锥体
介绍 Directx3D 9 什么是DirectX,非常好说了,Win32 C++ API.主要是多媒体编程方面的,长处体如今高性能了,如今我知道的版本号最高是D3D11,可是我是学习入门的,从D3D ...
- 基于mqtt协议实现手机位置跟踪
Mqtt协议是物联网领域的一个标准协议,具有轻巧,对设备,带宽要求低,可靠稳定的特点,适合用来实现手机定位跟踪功能. 目前我初步搭建起来了整个可运行的框架,大致为如下思路:1.手机端通过位置服务,获取 ...
- 报错:out of memory java heap space
PermGen space的全称是Permanent Generation space,是指内存的永久保存区域OutOfMemoryError: PermGen space从表面上看就是内存益出,解决 ...
- Joomla中的Task 和view 深入学习
[本文转自:梦溪笔记] Joomla 是一个优秀的CMS系统,她可以让你快速的完成一个网站的建设,她提供组件,模块,模板能够满足你大部分的网站需求.而组件在其中举足轻重. 一.基本知识 组件(comp ...
- oracle 错误代码表
ORA-00001: 违反唯一约束条件 (.) ORA-00017: 请求会话以设置跟踪事件 ORA-00018: 超出最大会话数 ORA-00019: 超出最大会话许可数 ORA-00020: 超出 ...
- HDU3374 String Problem —— 最小最大表示法 + 循环节
题目链接:https://vjudge.net/problem/HDU-3374 String Problem Time Limit: 2000/1000 MS (Java/Others) Me ...
- 教你开发jQuery插件
jQuery插件开发模式 软件开发过程中是需要一定的设计模式来指导开发的,有了模式,我们就能更好地组织我们的代码,并且从这些前人总结出来的模式中学到很多好的实践. 根据<jQuery高级编程&g ...
- fullcalendar小结
最近做的项目需要一个日程插件,在网上找了一些插件觉的fullcalendar 比较好用,总结一下以备后用. 效果图如下: var calendar = null; function ShowCalen ...
- Python学习笔记_Mysql数据库、Excel
一.操作mysql数据库 import pymysql # 1.连上数据库:账号,密码,ip,端口号,数据库 # 2.建立游标(去数据库拿东西的工人) # 3.执行sql # 4.获取结果 # 5.关 ...