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