预处理器指令(Preprocessor Directives)指导编译器在实际编译开始之前对信息进行预处理.
通过这些指令,可以控制编译器如何编译文件或编译哪些部分.常见的预处理器指令包括条件编译,宏定义等.
所有的预处理器指令都是以#开始,且在一行上,只有空白字符可以出现在预处理器指令之前.
预处理器指令不是语句,所以它们不以分号;结束.
C#编译器没有一个单独的预处理器,但是,指令被处理时就像是有一个单独的预处理器一样.在C#中,预处理器指令用于在条件编译中起作用.与C和C++不同的是,它们不是用来创建宏,一个预处理器指令必须是该行上的唯一指令.
C#预处理器指令列表
下表列出了C#中可用的预处理器指令:
|------------|---------------------------------------|
| 指令 | 描述 |
| #define | 定义一个符号,可以用于条件编译. |
| #undef | 取消定义一个符号. |
| #if | 开始一个条件编译块,如果符号被定义则包含代码块. |
| #elif | 如果前面的#if或#elif条件不满足,且当前条件满足,则包含代码块. |
| #else | 如果前面的#if或#elif条件不满足,则包含代码块. |
| #endif | 结束一个条件编译块. |
| #warning | 生成编译器警告信息 |
| #error | 生成编译器错误信息 |
| #region | 标记一段代码区域,可以在IDE中折叠和展开这段代码,便于代码的组织和阅读. |
| #endregion | 结束一个代码区域. |
| #line | 更改编译器输出中的行号和文件名,可以用于调试或生成工具的代码. |
| #pragma | 用于给编译器发送特殊指令,例如禁用或恢复特定的警告. |
| #nullable | 控制可空性上下文和注释,允许启用或禁用对可空引用类型的编译器检查. |
#define和#undef预处理器
#define用来定义符号(通常用于条件编译),#undef用于取消定义符号.
#define运行定义一个符号,这样,通过使用符号作为传递给#if指令的表达式,表达式将返回true.
条件指令:#if,#elif,#else和#endif
可以使用#if指令来创建一个条件指令.
条件指令用于测试符号是否为真.如果为真,编译器会执行#if和下一个指令之间的代码.
常见运算符有:
==(等于)
!=(不等于)
&&(与)
||(或)
可以用括号把符号和运算符进行分组.条件指令用于在调试版本或编译指定配置时编译代码.一个以#if指令开始的条件指令,必须显示地以一个#endif指令终止.
实例代码如下:
#warning和#error
#warning用于生成编译器警告,#error用来生成编译器错误
#region和#endregion
用于代码折叠,使代码更加可读.
#line
用于更改文件行号和文件名的编译器输出.
#pragma
用于向编译器发送特殊指令,最常见的用法是禁用特定的警告
#使用预处理器指令的注意事项
1.提高代码可读性:使用#region可以帮助分隔代码块,提高代码的组织性.
2.条件编译:通过#if等指令可以开发和生产环境中编译不同的代码,方便调试和发布.
3.警告和错误:通过#warning和#error可以在编译时提示开发人员注意特定问题.
一般在开发中使用最多的就是#region和#endregion.