預處理器指令指導編譯器在實際編譯開始之前先對資訊進行預處理。

所有的預處理器指令都是以 # 開始。且在一行上，只有空白字元可以出現在預處理器指令之前。預處理器指令不是語句，所以它們不以分號（;）結束。

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