分享来自逐浪CMS的ASP.NET应该遵守的9条代码编写规范

来源:互联网 发布:centos 6.5 yum配置 编辑:程序博客网 时间:2024/04/29 14:12

分享来自逐浪CMS的ASP.NET应该遵守的9条代码编写规范 

局部变量的名称要有意义,尽量用对应的英文命名,比如“用户姓名”变量,不要用aa bb cc等来命名,而要使用userName。


不要使用单个字母的变量,如i、n、x等。而要使用index、temp等。用于循环迭代的变量例外。


应该使用Pascal命名法命名方法名、属性名、类名和命名空间,且方法的命名一般将其命名为动宾短语,如:


以下为引用的内容:


◆ShowDialog();


◆CreateFile();


◆GetPath();



用Camel命名法命名局部变量和方法的参数。


以上几条综合举例如下:


以下为引用的内容:


public class Neeke
{
    publicNeeke()
    {
        
    }
 
    privatestring neekeName;
 
    publicstring NeekeName
    {
       get { return neekeName; }
       set { neekeName = value; }
    }
 
    public voidCallMe()
    {
       System.Console.WriteLine("Hello Neeke!");
    }
}



仅使用匈牙利命名法对WinForm和Web空间命名,禁止使用textbox1、gridview1等默认命名。


接口命名以大小写I作为前缀,如INeeke,以便直观的区分接口和类。


使用命名空间的层次性结构来组织各种类和接口。


正确:


以下为引用的内容:


using Www.Ineeke.Cn;
namespace Ineeke.Cn
{
 ...
}


错误:


以下为引用的内容:


using WwwIneekeCn;


namespace IneekeCn


{
 ...


}



所有代码必须保证有足够的注释,注释量要求在15%以上。需要注释的内容包括以下几种:

1)关键性语句(如关键的变量声明,条件判断等)。
2)类名前的文档注释(以//开头的注释)包括类的简单功能说明、使用方法等。
3)具有复杂参数列表的方法。


代码缩进用Tab键,不要使用空格键。


更多精彩内容请阅读:zoomla!逐浪CMS