首页 > 代码库 > C# 编码标准(二)

C# 编码标准(二)

  先八卦一下,昨天写了C# 编码标准(一),得到了@h82258652的补充,感到非常欣慰,一是感觉他的观点扩展了我的视野,丰富了我的看法,所以更坚定了我继续写博客的想法,由于是五笔打字,经常不写东西,有些字的字根都忘记了,所以通过写博客也可以多记些字根,二是决定把多年的一些东西分享出来,一起沟通交流,这样也能够共同进步,共同成长。

一、编码实践

1、一个文件的代码避免超过500行。当然这个在特殊情况下也是可以的,只是一个建设吧!

2、方法要避免超过25行。当然这个在特殊情况下也是可以的,只是一个建设吧!

3、每行不要超过80个字符。

4、不要手动编辑任何机器代码。

5、避免对显而易见的代码作注释,代码应该是自解释的,由可读性强的变量和方法组成的好的代码应该不需要注释。

6、除了“0”与“1”, 不要用数值硬编码,声明一个常量代替。

7、仅对本来就是常量的值使用const修饰符,例如一周的天数。

8、避免对只读的变更使用const,在此情况下,使用readonly修饰符:

public class MyClass{     public const int DaysInWeek = 7;     public readonly int Number;     public MyClass(int someValue)     {           Number = someValue;     }                 }    

9、仅捕捉你需要显式处理的异常。

10、在抛出异常的catch语句中,总是抛出最初异常(或由最初异常构建的另一个异常),以保持最初错误的堆栈位置。

第一种:catch(Exception ex){    MessageBox.Show(ex.Message);    throw;     // 等同于抛出原始异常}第二种:catch(Exception ex){    MessageBox.Show(ex.Message);    throw ex;     // 这样会吃掉异常点,重置堆栈中的异常起始点}第三种:catch{    throw;  // 可捕获所有类型的异常}第四种:catch(Exception ex){    MessageBox.Show(ex.Message);    throw new Exception("经过进一步包装的异常", ex);  // 经过进一步包装的异常,第二个参数保存了原来的异常信息}推荐使用第一种用法

11、最小化应用程序的程序集代码(即EXE客户端程序集)。用类库来包含业务逻辑。

12、避免显式类型转换。使用as操作符防御性地进行转换类型:

Dog dog = new GermanShepherd();GermanShepherd shepherd = dog as GermanShepherd;if (shepherd != null){   ...   }

13、调用委托前始终检查委托是否为空。

14、不要假定一种类型能支持某个接口。防御性地为接口查询是否支持该接口。

SomeType obj1;IMyInterface obj2;obj2 = obj1 as IMyInterface;if(obj2 != null){   obj2.Method1();   }else{    ...}

15、永远不要硬编码将呈现给用户的字符串,而是使用资源。

16、永远不要硬编码布署时可能修改的字符串,例如连接字符串。

17、用String.Empty代替"":

// 避免string name = "";//推荐string name = String.Empty;

18、当频繁地使用一个字符串超过4次,使用StringBuilder,不要使用string。

19、当提供一个静态成员变量时,总是提供一个静态构造函数。

20、除非在switch语句中跳转,否则永远不要用goto语句。

21、不要在使用泛型的代码中对System.Object进行类型转化。使用约束或as运算符:

class SomeClass{}// 避免class MyClass<T>{   void SomeMethod(T t)   {        object temp = t;        SomeClass obj = (SomeClass)temp;    }}// 建议class MyClass<T> where T : SomeClass{    void SomeMethod(T   t)    {        SomeClass obj = t;    }}

22、不要在泛型接口中定义约束条件。接口级别的约束常常可以用强类型代替:

public class Customer{...}// 避免public interface IList<T> where T : Customer{...}// 建议public interface ICustomerList : IList<Customer>

23、lock锁私有只读静态对象。不要使用lock (this)lock (typeof (MyType))lock ("myLock")等

 

C# 编码标准(二)