在C#中有许多名为“预处理指令”的命令,这些命令从来不会转化为可执行代码中的命令,但会影响编译过程的各个方面。例如,使用预处理器指令可以禁止编译器编译代码的某一部分。如果计划发布两个版本的代码,即基本版本和拥有更多功能的企业版本,就可以使用这些预处理器指令。在编译软件的基本版本时,使用预处理器指令可以禁止编译器编译与额外功能相关的代码。另外,在编写提供调试信息的代码时,也可以使用预处理器指令。实际上,在销售软件时,一般不希望编译这部分代码。
预处理指令的开头都有符号#。
1. #define和#undef
#define的用法如下所示:
#define DEBUG
它告诉编译器存在给定名称的符号,在本例中是DEBUG。这有点类似于声明一个变量,但这个变量并没有真正的值,只是存在而已。这个符号不是实际代码的一部分,而只在编译器编译代码时存在。在C#代码中它没有任何意义。
#undef正好相反,它删除符号的定义:
#undef DEBUG
如果符号不存在,#undef就没有任何作用。同样,如果符号已经存在,则#define也不起作用。必须把#define和#undef命令放在C#源文件的开头位置,在声明要编译的任何对象的代码之前。#define本身没有什么用,但与其他预处理器指令(特别是#if)结合使用时,它的功能就非常强大了。
2. #if/#elif/#elese/#endif
这个指令告诉编译器是否要编译某个代码块。考虑下面的方法:
int DoSomeWork(double x)
{
//do something
#if DEBUG
Console.WriteLine("x is "+x);
#endif
}
这段代码会像往常一样编译,但是Console.WriteLine命令包含在#if子句内。这行代码只有在前面的#define命令定义了符号DEBUG后才执行。当编译器遇到#if语句后,将先检查相关的符号是否存在,如果符号存在,就编译#if子句中的代码。否则,编译器会忽略所有的代码,直到遇到匹配的#endif指令为止。一般是在调试时定义符号DEBUG,把与调试相关的代码放在#if子句中。在完成了调试后,就把#define语句注释掉,所有的调试代码会奇迹般消失,可执行文件也会变小,最终用会不会被这些调试信息弄糊涂。这项技术在C和C++中十分常见,称为条件编译.
#elif(=else if)和#else指令可以用在#if块中,其含义非常直观。也可以嵌套#if块:
#define ENTERPRISE
#define W2K //further on in the file #if ENTERPRISE
//so something
#if W2K
//some code that is only relevant to enterprise
//edition running on W2K
#endif
#elif PROFESSIONAL
//do something else
#else
//code for the leaner version
#endif
#if和#elif还支持一组逻辑运算符"!"/"=="/"!="/"||"。如果符号存在,就被认为是true,否则为false,例如:
#if W2K && (ENTERPRISE==false) //if W2K is defined but ENTERPRISE isn't
范例
// preprocessor_if.cs
#define DEBUG
#define VC_V7
using System;
public class MyClass
{
static void Main()
{
#if (DEBUG && !VC_V7)
Console.WriteLine("DEBUG is defined");
#elif (!DEBUG && VC_V7)
Console.WriteLine("VC_V7 is defined");
#elif (DEBUG && VC_V7)
Console.WriteLine("DEBUG and VC_V7 are defined");
#else
Console.WriteLine("DEBUG and VC_V7 are not defined");
#endif
}
}
输出 DEBUG and VC_V7 are defined
3. #warning和#error
另两个非常有用的预处理器指令是#warning和#error,当编译器遇到它们时,会分别产生警告或错误。如果编译器遇到#warning指令,会给用户显示#warning指令后面的文本,之后编译继续进行。如果编译器遇到#error指令,就会给用户显示后面的文本,作为一条编译错误消息,然后会立即退出编译,不会生成IL代码。
使用这两条指令可以检查#define语句是不是做错了什么事,使用#warning语句可以让自己回顾 一下进行了哪些操作:
#if DUBUG && RELEASE
#error "You've defined DEBUG and RELEASE simultaneously!"
#endif #warning "Don't forget to remove this line before the boss tests the code!"
Console.WriteLine("*I hate this job*");
4. #line
#line指令可以用于改变编译器在警告和错误信息中显示的文件名和行号信息。这条指令用得并不多。如果编写代码时,在把代码发送给编译器前,要使用某些软件包改变输入的代码,就可以使用这个指令,因为这意味着编译器报告的行号或文件名与文件中的行号或编辑的文件名不匹配。#line指令可以用于还原这种匹配。也可以使用语法#line default把行号还原为默认的行号:
#1ine "Core.cs" // we happen to know this is line 164 in the file
// Core.cs, before the intermediate
// package mangles it.
// later on #line default // restores default line numbering
5. #pragma
#pragma指令可以抑制或者还原指定的编译警告。与命令行选项不同,#pragma指令可以在类或方法级别执行,对抑制警告的内容和抑制的时间进行更精细的控制。下面的例子禁止"字段未使用"警告,然后在编译MyClass类后还原该警告。
#pragma warning disable 169
Public class MyClass
{
int neverUsedField;
}
#pragma warning restore 169