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#)