C#项目开发规范

表意清晰的命名规范是程序规划的核心,如果整个系统所有的命名都与其功能相适合,并可以让人“望文知意”,例如“Age”、“SetAge ()”,可大大提高系统的可维护性和健壮性,并可使系统关系清晰。反之,如果命名不能反应其含义,例如“v001”、“f002 ()”,那么将适得其反。

说明

常用的命名风格如下。

(1)Pascal风格:包含一到多个单词,每一个单词第一个字母大写,其他字母小写,其余字母均小写。例如:CollegeStudent、HelloWorld等。

(2)Camel风格:包含一到多个单词,第一个单词首字母小写,其余单词首字母大写,其他字母均小写。例如:name、gender、somePara等。

下面就给出常用的一些命名规范,供读者在开发中参考。

1.命名空间

命名空间命名采用Pascal风格,取名的一般规则如下。

CompanyName.TechnologyName

例如:

Microsoft.Office

MyCompany.NamingRule.Test

另外,需要用复数的时候要使用复数的名称空间名。例如,使用System.Collections而不是System.Collection。但是,当遇到缩写形式时,通常不需要使用复数。例如:使用System.IO而不是System.IOs。

名称空间和类不能使用同样的名字。例如,有一个类被命名为Student后,就不要再使用Student作为一个名称空间。

2.类

C#中的类命名采用Pascal命名风格,取名的规则如下。

(1)在为类命名前首先要知道该类的作用,尽量以名词或名词短语命名,使程序员通过类名提供的线索,便可以了解这个类的基本功能。

(2)尽量不使用缩写,而用全写。例如:使用CollegeStudent而不用CollegeStu。

(3)不要使用任何类前缀(例如C)和后缀(例如Class)。

(4)不要使用带下划线的字符(例如College_Student)。

下面是一个合理的类名的示例。

代码19-1  类命名示例

/// <summary>

/// 类名:Pascal命名风格,形如SomeClass。

/// </summary>

pulibc class CollegeStudent

{

      …

}

3.私有成员

类的成员变量采用Camel风格,并使用前缀m_或者_。下面是一些合理的私有成员示例。

代码19-2  私有成员命名示例

class CollegeStudent

{

      /// <summary>

      /// 私有成员命名:Camel命名风格,形如member。

      /// </summary>

      private string m_name;

      private int m_age;

}

另外,有些程序员习惯于使用数据类型前缀,用来确定参数的数据类型。例如strName、nAge等,但这不是通用的规范。

4.属性

类的属性采用Pascal风格。下面是一些合理的属性示例。

代码19-3  属性命名示例

class CollegeStudent

{

      /// <summary>

      /// 属性命名:Pascal命名风格,形如Name。

      /// </summary>

      public string Name

      {

            set

            {

                     if(value!=null)

                            this.m_name=value;

            }

            get

            {

                     return this.m_name;

            }

      }

}

5.方法

通常每个方法都是执行类的一个“动作”,所以对方法的命名应该清楚地说明该方法是做什么的,用“动词+名词”的结构可以更加清晰的表达这种含义。例如,用ShowInfo()代替Info(),用LoadData()代替DataLoad(),这样做的目的是更加明确这个方法的功能。

下面是一些合理的方法名示例。

代码19-4  方法命名示例

class CollegeStudent

{

      /// <summary>

      /// 方法名:Pascal命名风格,形如SomeMethod。

      /// </summary>

      public void EnterSchool() {…}

}

另外,常常使用一些前缀来表达方法的含义,如下。

(1)Is的含义为问一个关于某样事物的问题。例如:IsMale()。

(2)Get的含义为取得一个数值。例如:GetInfo()。

(3)Set的含义为设定一个数值。例如:SetInfo()。

6.方法参数

C#中,方法的参数采用camel风格。另外,有些程序员习惯于使用数据类型前缀,用来确定参数的数据类型。例如strName、nAge等。

下面是一些方法参数命名的示例。

代码19-5  方法参数命名示例

class CollegeStudent

{

      public void SetInfomation(string name,int age){…}

}

7.接口

同方法相似,接口采用Pascal命名规范,取名的规则如下。

(1)使用I作为前缀,表示其为一个接口。

(2)使用名词或名词短语,或者描述行为的形容词来命名接口。例如IComponent(描述性名词)、ICustomAttributeProvider(名词短语)和IPersistable(形容词)。

(3)尽量不使用缩写,而用全写。例如:使用IComponent而不用IComp。

(4)不要使用带下划线的字符(例如ICustom_AttributeProvider)。

例如:

代码19-6  接口命名示例

class CollegeStudent

{

      /// <summary>

      /// 接口名:Pascal命名风格,形如ISomeInterface。

      /// </summary>

      public interface IPlay{};

}

8.变量

局部变量采用camel风格,并尽量使用描述性强的名词或名词短语,并且不使用缩写,如使用number,而不使用num。下面是一些变量命名的示例。

int number=0;

string sqlString=””;

double averageScore=0.0;

CollegeStudent collegeStudent=new CollegeStudent();

你可能感兴趣的:(String,C#,null,Class,interface,pascal)