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,或在符号前放置否定運算符。
常見運算符有:
- == (等于)
- != (不等于)
- && (與)
- || (或)
您也可以用括号把符号和運算符進行分組。條件指令用于在調試版本或編譯指定配置時編譯代碼。一個以 #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