预处理器指令

预处理器指令概述

预处理器指令（Preprocessor Directives）是编译器在实际编译代码之前执行的指令。通过这些指令，开发者可以控制编译器如何处理源代码的不同部分，例如条件编译。所有预处理器指令都以 # 开头，并且必须是该行上的唯一指令。

预处理器指令不是C#语句，因此不需要以分号 ; 结束。

C# 预处理器指令与C和C++中的不同之处在于，它们不用于创建宏，而主要用于条件编译和控制编译过程。

常见的预处理器指令

指令	描述
#define	定义一个符号，用于条件编译。
#undef	取消定义一个符号。
#if	开始一个条件编译块，如果符号被定义则包含代码块。
#elif	如果前面的 #if 或 #elif 条件不满足，且当前条件满足，则包含代码块。
#else	如果前面的 #if 或 #elif 条件不满足，则包含代码块。
#endif	结束一个条件编译块。
#warning	生成编译器警告信息。
#error	生成编译器错误信息。
#region	标记一段代码区域，可以在IDE中折叠和展开这段代码。
#endregion	结束一个代码区域。
#line	更改编译器输出中的行号和文件名，用于调试或生成工具的代码。
#pragma	给编译器发送特殊指令，例如禁用或恢复特定的警告。
#nullable	控制可空性上下文和注释，启用或禁用对可空引用类型的编译器检查。

实例

条件编译

使用 #define 和 #undef 定义或取消定义符号，然后使用 #if、#elif、#else 和 #endif 进行条件编译。例如：

#define DEBUG

#if DEBUG
    Console.WriteLine("Debug mode");
#elif RELEASE
    Console.WriteLine("Release mode");
#else
    Console.WriteLine("Other mode");
#endif

在上面的示例中，如果定义了 DEBUG 符号，则编译器会包含 Console.WriteLine("Debug mode"); 语句。

生成警告和错误

使用 #warning 和 #error 生成编译器警告和错误信息。

#warning This is a warning message
#error This is an error message

代码区域

使用 #region 和 #endregion 定义代码区域，可以在IDE中折叠和展开这段代码。

#region MyRegion
    // Your code here
#endregion

更改行号和文件名

使用 #line 更改编译器输出中的行号和文件名，便于调试。

#line 100 "MyFile.cs"
// The next line will be reported as line 100 in MyFile.cs
Console.WriteLine("This is line 100");
#line default
// Line numbering returns to normal

编译器指令

使用 #pragma 向编译器发送特殊指令，例如禁用或恢复特定的警告。

#pragma warning disable 414
private int unusedVariable;
#pragma warning restore 414

可空性上下文

使用 #nullable 控制可空性上下文和注释。

#nullable enable
string? nullableString = null;
#nullable disable

#define 和 #undef

#define 用于定义符号，通常用于条件编译。#undef 用于取消定义符号。

#define DEBUG
#undef RELEASE

#if DEBUG
    Console.WriteLine("Debug mode");
#endif

通过使用 #define 和 #undef，可以灵活地控制代码的编译部分，使其适应不同的环境和需求。