C# 預處理器指令
預處理器指令指導編譯器在實際編譯開始之前對信息進行預處理。
所有的預處理器指令都是以# 開始。 且在一行上,只有空白字符可以出現在預處理器指令之前。 預處理器指令不是語句,所以它們不以分號(;)結束。
C# 編譯器沒有一個單獨的預處理器,但是,指令被處理時就像是有一個單獨的預處理器一樣。 在C# 中,預處理器指令用於在條件編譯中起作用。 與C 和C++ 不同指令不用,它們不是用來創建宏。 一個預處理器指令必須是該行上的唯一指令。
C# 預處理器指令列表
下表列出了C# 中可用的預處理器指令:
预处理器指令 | 描述 |
---|---|
#define | 它用于定义一系列成为符号的字符。 |
#undef | 它用于取消定义符号。 |
#if | 它用于测试符号是否为真。 |
#else | 它用于创建复合条件指令,与 #if 一起使用。 |
#elif | 它用于创建复合条件指令。 |
#endif | 指定一个条件指令的结束。 |
#line | 它可以让您修改编译器的行数以及(可选地)输出错误和警告的文件名。 |
#error | 它允许从代码的指定位置生成一个错误。 |
#warning | 它允许从代码的指定位置生成一级警告。 |
#region | 它可以让您在使用 Visual Studio Code Editor 的大纲特性时,指定一个可展开或折叠的代码块。 |
#endregion | 它标识着 #region 块的结束。 |
#define 預處理器
#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
條件指令
您可以使用#if 指令來創建一個條件指令。 條件指令用於測試符號是否為真。 如果為真,編譯器會執行#if 和下一個指令之間的代碼。
條件指令的語法:
#if symbol [operator symbol]...
其中, symbol是要測試的符號名稱。 您也可以使用true 和false,或在符號前放置否定運算符。
運算符符號是用於評價符號的運算符。 可以運算符可以是下列運算符之一:
- == (equality)
- != (inequality)
- && (and)
- || (or)
您也可以用括號把符號和運算符進行分組。 條件指令用於在調試版本或編譯指定配置時編譯代碼。 一個以#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