前處理器指令用來在編譯開始之前給編譯器指示預處理資訊。
所有預處理程式指令以符號#
開頭,並且只有空格字元在一行上,空格符可前處理器指令之前出現。 前處理器指令不是語句,所以它們不以分號(;
)結尾。
C# 編譯器沒有分隔前處理器;,指令被處理為只有一個。 在 C# 中,預處理指令用於指示條件編譯。與C語言和C++指令不同,它們不用於建立巨集。 預處理程式指令必須是一行中的唯一指令。
下表列出了 C# 中提供的預處理指令:
預處理指令 | 描述 |
---|---|
#define |
定義一個叫作符號的字元序列。 |
#undef |
用於取消定義的符號。 |
#if |
用來測試符號以檢視它們是否為真。 |
#else |
用來與#if 來建立一個複合條件指令。 |
#elif |
用來建立一個複合條件指令。 |
#endif |
指定條件指令的結束。 |
#line |
用於修改編譯器的行號和(可選)修改錯誤和警告的檔案名輸出。 |
#error |
用於從程式碼中的特定位置生成錯誤。 |
#warning |
用於從程式碼中的特定位置生成一級警告。 |
#region |
允許您在使用Visual Studio程式碼編輯器的概述功能時指定可以展開或折疊的程式碼塊。 |
#endregion |
用於標誌著#region 塊的結束。 |
#define
預處理程式指令建立符號常數。#define
允許定義一個符號,通過使用該符號作為傳遞給#if
指令的表示式,表示式的計算結果為true
。其語法如下:
#define symbol
以下程式演示如何使用#define
指令:
#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
指令建立條件指令。條件指令用於測試符號檢查它們的值是否為真。 如果它們評估求值為true
,編譯器將評估求值#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