第8章 C# 编程风格约定

8.1. 通用风格约定

8.1.1. 花括号的使用

ü 左花括号“{”放在关键字或方法的下一行并与之对其。

例如：

if (n > 0)

{

...

}

private void Work(int n)

{

...

}

 

ü 左花括号“{”要与相应的右花括号“}”对齐。

 

ü 在通常情况下，左花括号“{”单独成行，不与任何语句并列成行。

 

ü if、while、do语句后一定要使用{}，即时{}号中为空或只有一条语句。

例如：

if (n > 10)

{

Work(n);

}

 

8.1.2. 空格的使用

ü 关键字和左括号“（”应该用空格隔开。

例如：

for (int i = 0; i < 10; i++)

{

...

}

 

ü 在方法名和左括号“（”之间不要用空格，这样有助于辨认代码中的方法调用和关键字。

 

ü 多个参数用逗号“，”隔开，每个逗号后都应加一个空格。

 

ü 除了“.”之外，所有二元操作符都应该与它们的操作数隔开。一元操作符、++ 及 -- 与操作数间不需要空格。

例如：

a += c + d;

a = (a + b) / (c * d);

while (d++ == s++)

{

n++;

}

Console.WriteLine("num is" + n);

 

ü 语句中的表达式之间要用空格隔开。

例如：

for (expr1; expr2; expr3)

{

...

}

 

8.1.3. 缩进的使用

ü 要用4个连续的空格符来进行缩进。

 

û 不要用制表符（Tab）来进行缩进。

 

ü 要对代码块中的内容进行缩进。

例如：

if (someExpression)

{

DoSomething();

}

 

ü 要对Case代码块进行缩进，尽管没有使用花括号。

例如：

switch (someExpression)

{

case 0:

DoSomething();

break;

}

8.2. 命名空间引用约定

ü 引用解决方案的其他工程的类，在头文件中引用全部路径，如：

using Codyy.CocoGlobalSession.GlobalSessionClient.RegionSession.GroupOp;

RegionSessionGroupOpServiceProxyMethod regionSessionGroupOpServiceProxyMethod

= new RegionSessionGroupOpServiceProxyMethod();

如果一个解决方案中的两个工程中定义了相同的类，实例化该类时要指定全路径。

 

ü 引用本工程的类，写出全部路径， 如：

GlobalSessionUtility.SessionUtility.GroupSession groupSession = newGlobalSessionUtility.SessionUtility.GroupSession();

8.3. 命名约定

ü 要在命名命名空间、类型及成员时采用PascalCasing大小写风格。

 

ü 私有字段用PascalCasing命名，并加上前缀“m_”。

例如：

private int m_ValueOne;

 

ü 私有静态变量用PascalCasing命名，并加上前缀“s_”。

static s_ValueTwo;

private static s_ValueThree;

 

ü 全局变量用PascalCasing命名。

internal static string GlobalSessionId;

 

ü 要用camelCasing命名局部变量。

 

ü 要用camelCasing命名方法的形式参数。

 

û 不要用匈牙利命名法。

 

û 避免给局部变量加前缀。

 

ü 要使用c#语言中对应的别名，不要使用.net框架中的类型名。

例如：要使用int 而不是Int32，要使用object而不是Object。

8.4. 注释

û 不要用注释来描述一些对任何人都显而易见的事。

 

ü 代码块的注释，避免使用块注释语法（/*…*/）。即使注释会有多行，也最好是使用单行注释语法（//…）。

 

ü 类、方法、构造函数、属性等非代码块注释采用以下形式：

/// <summary>

/// 主函数入口

/// </summary>

/// <param name="args">参数说明</param>

static void Main(string[] args)

{

}

 

û 不要把注释放在行尾，除非特别短。

//注释语句

TestVirtual t2 = new TestOverride(); //除非特别短，否则不要在此注释

 

8.5. 文件的组织

û 不要在一个源文件中包含一个以上的公用类型，除非有嵌套类，或各类型之间的不同之处仅在于泛型参数的数量。一个文件中有多个内部类型是允许的。

 

ü 要用相同的名字来命名源文件及其包含的公用类型。

例如：String类应该在String.cs文件中。

 

ü 考虑根据下面给出的顺序和组别来对成员进行分组。

Ø 所有字段。

Ø 所有构造函数。

Ø 公有属性及其受保护的属性。

Ø 方法（所有显式实现的接口方法、内部方法、私有方法）。

Ø 事件。

Ø 所有嵌套类型。

例如：

public class TestClass

{

#region 字段

#endregion

 

#region 构造函数

#endregion

 

#region 属性

#endregion

 

#region 方法

#region 接口方法

#endregion

#region 内部方法

#endregion

#region 私有方法

#endregion

#endregion

 

#region 事件

#endregion

 

#region 嵌套类型

#endregion

}

 

ü 要把不能公开访问的成员和显式实现的接口成员分别放在自己的#region块中。

#region 不能公开访问的成员

#endregion

#region 显式实现的接口成员

#endregion

 

ü 考虑在每个组别内根据字母顺序来组织成员。

 

ü 考虑根据由简单到复杂的顺序来组织重载成员。

 

ü 要把using指令放在命名空间生命之外。