C# 预处理器指令(学习心得 24)
预处理器指令:指导编译器在实际编译开始之前对信息进行预处理。
所有的预处理器指令都是以 # 开始。
在一行上,只有空白字符可以出现在预处理器指令之前。
预处理器指令不是语句,所以它们不以 分号(;)结束。
一个预处理器指令必须是该行上的唯一指令。
@[TOC]
一、C# 预处理器指令列表
C# 中可用的预处理器指令:
预处理器指令 | 描述 |
---|---|
#define | 它用于定义一系列成为符号的字符。 |
#undef | 它用于取消定义符号。 |
#if | 它用于测试符号是否为真。 |
#else | 它用于创建复合条件指令,与 #if 一起使用。 |
#elif | 它用于创建复合条件指令。 |
#endif | 指定一个条件指令的结束。 |
#line | 它可以让您修改编译器的行数以及(可选地)输出错误和警告的文件名。 |
#error | 它允许从代码的指定位置生成一个错误。 |
#warning | 它允许从代码的指定位置生成一级警告。 |
#region | 它可以让您在使用 Visual Studio Code Editor 的大纲特性时,指定一个可展开或折叠的代码块。 |
#endregion | 它标识着 #region 块的结束。 |
1.1 #define 预处理器
#define 预处理器指令:创建符号常量。
这样,通过使用符号作为传递给 #if 指令的表达式,表达式将返回 true。
语法:
#define symbol
例:
#define PI
using System;
namespace PreprocessorDAppl
{
class Program
{
static void Main(string[] args)
{
#if (PI)
Console.WriteLine("PI is defined");
#else
Console.WriteLine("PI is not defined");
#endif
Console.ReadKey();
}
}
}
运行结果:
PI is defined
1.2 条件指令
使用 #if 指令来创建一个条件指令。
条件指令用于测试符号是否为真。
如果为真,编译器会执行 #if 和下一个指令之间的代码。
语法:
#if symbol [operator symbol]...
symbol 是要测试的符号名称。您也可以使用 true 和 false,或在符号前放置否定运算符。
常见运算符有:
- == (等于)
- != (不等于)
- && (与)
- || (或)
一个以 #if 指令开始的条件指令,必须显示地以一个 #endif 指令终止。
例:
#define DEBUG
#define VC_V10
using System;
public class TestClass
{
public static void Main()
{
#if (DEBUG && !VC_V10)
Console.WriteLine("DEBUG is defined");
#elif (!DEBUG && VC_V10)
Console.WriteLine("VC_V10 is defined");
#elif (DEBUG && VC_V10)
Console.WriteLine("DEBUG and VC_V10 are defined");
#else
Console.WriteLine("DEBUG and VC_V10 are not defined");
#endif
Console.ReadKey();
}
}
运行结果:
DEBUG and VC_V10 are defined
二、预处理器指令的用途理解
在程序调试和运行上有重要的作用。
比如预处理器指令可以禁止编译器编译代码的某一部分,如果计划发布两个版本的代码,即基本版本和有更多功能的企业版本,就可以使用这些预处理器指令来控制。
在编译软件的基本版本时,使用预处理器指令还可以禁止编译器编译于额外功能相关的代码。
另外,在编写提供调试信息的代码时,也可以使用预处理器指令进行控制。
总的来说和普通的控制语句(if等)功能类似,方便在于预处理器指令包含的未执行部分是不需要编译的。