转:Effective C#》Item 4:使用Conditional属性来代替IF/ENDIF程序块

转载 2007年09月30日 10:33:00

转:http://dev.csdn.net/author/Knight94/e5631391c7e54aff8cdd5e921dec8966.html

《Effective C#》Item 4:使用Conditional属性来代替IF/ENDIF程序块

 

在编码的时候,有时候需要添加一些DEBUG信息,来为了方便调试程序,但是到了真正发布的时候,又不希望把这些信息进行编译发布。那么在以前C或者C++编码的时候,用IF/ENDIF来定义程序块实现这个功能,而此方法在C#中可以继续沿用。
 
这种用IF/ENDIF来增加DEBUG信息块有两种方式,如下:
方式一,在一个函数中进行嵌入,例如:
#if DEBUG
            Trace.WriteLine( "ErrorMessage!" );
#endif
 
方式二,用IF/ENDIF填充整个函数,然后在需要加载的地方调用此函数即可,例如:
        private void DEBUG_TRACE( string strMsg )
        {
#if DEBUG
            Trace.WriteLine( strMsg );
#endif
        }
 
就这两种方式而言,都分别有些不足的地方。
对于方式一来说,首先增加过多的IF/ENDIF程序块,会使程序变得晦涩,而且代码太混乱。除此外,程序有可能出现潜在的BUG,考虑如下代码。
            string strMsg = null;
#if DEBUG
            strMsg = "Hello world!";
            Trace.WriteLine( strMsg );
#endif
            Console.WriteLine( strMsg );
这段代码,在DEBUG版本中一点儿问题都没有,但是在RELEASE版本中,由于会把IF/ENDIF这段程序块不会进行编译,那么就相当于如下:
            string strMsg = null;
            Console.WriteLine( strMsg );
很明显,如上这段代码是有问题的,而且这种问题也很难查出来。
 
而对于方式二来说,可以屏蔽方式一的缺陷,即至少程序看得不那么晦涩,而且会屏蔽方式一所存在的潜在BUG。但是它的实现方式是一个函数,虽说在RELEASE中,这个函数相当于一个空函数,什么都不干,不过在程序执行的时候,会在这个函数的调用以及返回损失一些效率。
 
在如上的两种方式中,我更喜欢后者,也就是说我宁可丧失一些效率,而不愿降低代码可读性。不过在C#中,有一种更好的方式来实现IF/ENDIF的功能,就是在函数上增加Conditional属性,从而达到和方式二一样的效果,例如:
    [Conditional( "DEBUG" )]
    private void DEBUG_TRACE( string strMsg )
    {
        Console.WriteLine( strMsg );
    }
 
很显然这种写法,非常清晰,代码简洁,且容易阅读。而且这种写法和方式二一样,也可以屏蔽潜在的BUG。对于效率来说,它的效率和方式一一样,我用如下的调用代码来说明。
    DEBUG_TRACE( "ERROR MESSAGE1" );
    Console.WriteLine( "Hello world!" );
    DEBUG_TRACE( "ERROR MESSAGE2" );
 
对于这段代码在RELEASE中生成的IL代码和如下的代码一样。
    Console.WriteLine( "Hello world!" );
 
根据如上的阐述,可以很轻松获得如下的一个对比表。
 
IF/ENDIF程序块
Conditional属性
第一种方式
第二种方式
代码可读性
差,晦涩
较好
最好
效率
其他
存在潜在BUG
不存在潜在BUG
不存在潜在BUG
 
不过使用Conditional属性的函数有个限制,就是不能有返回值,即必须以void来定义返回值。
 
而且用Conditional来增加多个属性,例如:
    [Conditional( "DEBUG" ),Conditional( "TRACE" )]
    private void DEBUG_TRACE( string strMsg )
    {
        Console.WriteLine( strMsg );
    }
 
不过这两个属性之间的关系是或的关系,即“DEBUG”或者“TRACE”任意一个被定义了,那么这段代码就会被执行。如果需要增加两个并的属性,直接用Conditional是无法实现的,需要借助IF/ENDIF来完成,如下:
    #if( DEBUG && TRACE )
    #define BOTH
#endif
    [Conditional( "BOTH" )]
    private void DEBUG_TRACE( string strMsg )
    {
        Console.WriteLine( strMsg );
    }
 
方法已经说到这里,可以基本上说完了。接下来,就说说如何设置环境变量,在C#中有三种设置方法。
方法一,直接在程序中加入,需要在一个文件的开头进行定义;
方法二,在项目中的编译命令行中进行设置;
方法三,是在操作系统中增加环境变量。
 
这三种方法,最常用的是前两种,具体如何设置,我这里不做细讲,参看MSDN即可完成

 

Effective C# Item32:尽可能实现小尺寸、高内聚的程序集

我们在划分程序集时,经常会犯的一个错误:在一个程序集中放入了太多的东西,导致程序集很难被重用。     一个好的程序集应该是“高内聚”的,所谓内聚,是指将程序集封装为一个有意义、有职责的单位,它一般可...

[Effective Java Distilled] Item 3 通过使用私有构造方法或者枚举类型来强化单例属性

关于Effective Java Distilled: 《Effective Java》这本书我断断续续的读了近两遍,里面的内容挺有深度,对提高工程代码质量也非常有帮助。我打算慢慢的整理出来一个...

[Effective Java Distilled] Item 3 通过使用私有构造方法或者枚举类型来强化单例属性

关于Effective Java Distilled: 《Effective Java》这本书我断断续续的读了近两遍,里面的内容挺有深度,对提高工程代码质量也非常有帮助。我打算慢慢的整理出来一个...

Effective C# Item6:明辨值类型和引用类型的使用场合

可能是受到Java的影响,我在转向C#后,一直没有注意区分过值类型和引用类型,不论是编写新代码还是重构旧代码时,如果发现有一些信息需要独立出来时,一直都是以新建类的方式进行,很少考虑使用结构体(我到目...

《Effective C++》Item4:确定对象被使用前已先被初始化

Questions:   (1)为什么需要在对象使用前初始化? (2)关于默认构造函数的几点认识? (3)为什么要使用参数初始化表进行初始化?   -------------------------...

【Effective Java】Ch4_Class:Item14_在public类中应该使用访问方法而不是public域

public类永远不要暴露其可变的字段。而public类暴露其不可变字段随然是有问题,但危害性要小一些。然而,package-private或者private的嵌套类暴露其字段则是可行的,无论该字段是...

《Effective C#》Item 11:提倡使用foreach语句来进行循环操作

循环语句是编程的基本语句,在C#中除了沿用C语言的循环语句外,还提供了foreach语句来实现循环。那么我要说的就是,在循环操作中尽量使用foreach语句来实现。   为了来更好地说明为什么要提...

Effective C++ Item 4 确定对象被使用前已先被初始化

经验1:为内置对象进行手工初始化,因为C++不保证初始化它们
  • zhsenl
  • zhsenl
  • 2014年05月22日 21:26
  • 573

C# #if, #else和#endif预处理指令

http://www.cnblogs.com/Peter-Luo/archive/2012/04/06/2434803.html #if 使您可以开始条件指令,测试一个或多个符号以查看它们是...
  • plean
  • plean
  • 2012年04月27日 14:19
  • 1088

【C#】利用Conditional属性完成编译忽略

Conditional是.NET提供关于编译的属性描述,其作用是添加到方法或属上,通过定义编译符的方式告指示编译器应忽略方法调用或属性在我们的代码中经常会出现Console.WriteLint(“XX...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:转:Effective C#》Item 4:使用Conditional属性来代替IF/ENDIF程序块
举报原因:
原因补充:

(最多只允许输入30个字)