C# 預處理器指令（學習心得 24）

預處理器指令：指導編譯器在實際編譯開始之前對信息進行預處理。

所有的預處理器指令都是以 # 開始。

在一行上，只有空白字符可以出現在預處理器指令之前。

預處理器指令不是語句，所以它們不以 分號（;）結束。

一個預處理器指令必須是該行上的唯一指令。

一、C# 預處理器指令列表

C# 中可用的預處理器指令：

預處理器指令	描述
#define	它用於定義一系列成爲符號的字符。
#undef	它用於取消定義符號。
#if	它用於測試符號是否爲真。
#else	它用於創建複合條件指令，與 #if 一起使用。
#elif	它用於創建複合條件指令。
#endif	指定一個條件指令的結束。
#line	它可以讓您修改編譯器的行數以及（可選地）輸出錯誤和警告的文件名。
#error	它允許從代碼的指定位置生成一個錯誤。
#warning	它允許從代碼的指定位置生成一級警告。
#region	它可以讓您在使用 Visual Studio Code Editor 的大綱特性時，指定一個可展開或摺疊的代碼塊。
#endregion	它標識着 #region 塊的結束。

1.1 #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

1.2 條件指令

使用 #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

二、預處理器指令的用途理解

在程序調試和運行上有重要的作用。

比如預處理器指令可以禁止編譯器編譯代碼的某一部分，如果計劃發佈兩個版本的代碼，即基本版本和有更多功能的企業版本，就可以使用這些預處理器指令來控制。

在編譯軟件的基本版本時，使用預處理器指令還可以禁止編譯器編譯於額外功能相關的代碼。

另外，在編寫提供調試信息的代碼時，也可以使用預處理器指令進行控制。

總的來說和普通的控制語句（if等）功能類似，方便在於預處理器指令包含的未執行部分是不需要編譯的。