C#预处理器指令

下面对C#中的预编译指令进行介绍:html

1.#define和#undef

用法:git

      #define DEBUG编辑器

      #undef DEBUGide

      #define告诉编译器,我定义了一个DEBUG的一个符号,他相似一个变量,可是它没有具体的值,能够将它看为一个符号而已。#undef就是删除这个符号的定义。若是符号DEBUG没定义过,则#undef不起做用,不然#define不起做用。两者都必须放在源代码以前。两者的顺序看代码的顺序:布局

      #define DEBUG post

      #undef  DEBUGui

      这样的话,DEBUG是没有定义的,若是两者换个顺序,编译器就认为DEBUG被定义了this

2.#if、#elif、#else、#endif

      这个告诉编译器进行编译代码的流程控制。考虑下面代码:编码

            #if DEBUGspa

                  Console.Write("debug");

            #elif RELEASE

                  Console.Write("release");

            #else

                  Console.Write("other");

            #endif

      以上代码就是说若是定义了DEBUG则输出debug,定义了RELEASE,则输出realse,不然输出other。若是定义了DEBUG和REALSE会怎么样呢?各位能够本身试一下。

3.#warning、#error

      经过这两个指定能够告诉编译器,出一个警告仍是错误信息。除了错误信息之后,编译将中止。

      参考下面的代码(C#在Debug状态下自动定义DEBUG标志,但Release状态不会自动定义RELEASE标志):

            #if DEBUG 

                  #warning 如今是Debug状态

            #elif RELEASE

                  #warning 如今是Release状态

            #else

                  #error 并清楚什么状态

            #endif

4.#region 和#endregion

      这个两个用来组成代码块。

5.#line

      这个指令能够改变编译器在警告和错误信息中显示的文件名和行号信息,用#line default把行号恢复为默认的行号。

      #line [ number ["file_name"] | default ]

      number 

            要为源代码文件中后面的行指定的编号。

      "file_name"(可选)

            但愿出如今编译器输出中的文件名。默认状况下,使用源代码文件的实际名称。文件名必须括在双引号 ("") 中。

      default

            重置文件中的行编号。

      备注:

            #line 可能由生成过程当中的自动中间步骤使用。例如,若是中间步骤从原始的源代码文件中移除行,可是您仍但愿编译器基于文件中的原始行号生成输出,则能够移除行,而后用 #line 模拟原始行号。

      下面的示例说明如何报告与行号关联的两个警告。#line 200 指令迫使行号为 200(尽管默认值为 #7)。另外一行 (#9) 做为默认 #line 指令 的结果跟在一般序列后。

示例1:

      // preprocessor_line.cs
      public class MyClass2
      {
            public static void Main()
            {
                  #line 200
                  int i;       // line 200
                  #line default
                  char c;  // line 9
            }
      }

示例2:

      下面的示例说明调试器如何忽略代码中的隐藏行。运行此示例时,它将显示三行文本。可是,当设置如示例所示的断点并按 F10 键逐句经过代码时,您将看到调试器忽略了隐藏行。另请注意,即便在隐藏行上设置断点,调试器仍会忽略它。

      // preprocessor_linehidden.cs
      using System;
      class MyClass
      {
            public static void Main()
            {
                  Console.WriteLine("Normal line #1.");  // Set a break point here.
                  #line hidden
                  Console.WriteLine("Hidden line.");
                  #line default
                  Console.WriteLine("Normal line #2.");
            }
      }

6.#pragma

       能够抑制或恢复指定的编译警告。与命令行选项不一样,#pragma指令能够在类和方法上执行,对抑制什么警告和抑制的时间进行更精细的控制。

       #pragma warning disable 169
       public class Aclass
       {
               int nFiled;
       }
       #pragma warning restore 169

出处:http://blog.sina.com.cn/s/blog_6ae1dc950100nf3f.html

======================================================================================

  C#的预处理器指令很容易识别,你看到了#,就能认出它们。

  它和其余的命令有什么区别呢?

  区别在于这些命令历来不会转化为可执行代码的命令,可是会影响编译过程的各个方面。

  它用来作什么呢?

  当计划发布两个版本的代码的时候。即基本版和拥有更多版本的企业版,就能够用到预处理器指令。

  在编译基本版的时候,使用预处理指令会禁止编译器编译与额外功能相关的代码。

  另外,在编写提供调试信息的代码时,也可使用预处理器指令。

  下面介绍预处理器指令的功能:

  #define和#undef

  #define用法:  #define Debug

  Debug能够看作是声明的一个变量,但此变量没有真正的值,仅存在。

  #define单独用没什么意义,通常是和#if结合使用。

  #undef用法:   #undef Debug

  做用就是删除Debug的定义。若是Debug符号不存在,这条指令就没有任何做用。若是Debug符号存在,则以前的#define就没有做用。 

  #define与#undef声明必须放在C#源文件的开头位置,即程序集的引用的上方。

 

  #if,#elif,#else和#endif

  下面来看一个例子  

复制代码
//#define DebugA
#define DebugB
using System;

namespace MyApplication
{
    class Program
    {
        static void Main(string[] args)
        {
#if DebugA
            Console.WriteLine("Hello DebugA");
#elif DebugB
            Console.WriteLine("Hello DebugB");
#else
            Console.WriteLine("Hello Debugelse");
#endif
        }
    }
}
复制代码

  #elif(=else if)和#else指令能够用在#if中,和C#中的if,else if,else含义相同。

  #if和#elif支持一组逻辑运算符"!","==","!="和"||",若是符号存在,则为true。

  #if DebugB && DebugA  //当Debug与DebugA同时存在才会执行

 

  #warning和#error

  当编译器遇到这两条指令时,会分别产生警告和错误。若是编译器遇到#warning指令,会显示该指令后的文本,以后继续编译。

  若是碰见#error指令,也会显示指令后面的文本。但会马上退出编译,不会产生IL代码。(其实和编译器的警告和错误意义相同) 

复制代码
        static void Main(string[] args)
        {
#warning "All Right?"
            Console.WriteLine("Contine...");
//#error "All Right?"
//            Console.WriteLine("Contine...");
        }
复制代码

  下图为放开#error注释:

 

  #region和#endregion

  这两条指令,你们应该很是熟悉,做用就是代码缩进和指定该代码块的名称,使得代码能够更好的布局。详细用法能够参照报表系列的代码。

 

  #line

  这条指令不多用到。做用就是:若是代码在编译以前,要使用某些软件包改变输入的代码,就可使用它。

  (其实就是更改代码的行号)

 

  #pragma warning

  此指令可启用或禁用某些警告。

  用法:  #pragma warning disable warning-list
            #pragma warning restore warning-list

  例子: 

 

using System;

#pragma warning disable 414, 3021
[CLSCompliant(false)]
public class C
{
    int i = 1;
    static void Main()
    {
    }
}
#pragma warning restore 3021
[CLSCompliant(false)]  // CS3021
public class D
{
    int i = 1;
    public static void F()
    {
    }
}

 

 

  #pragma checksum

  做用是生成源文件的校验和,以帮助调试 ASP.NET 页。

   用法:  #pragma checksum "filename" "{guid}" "checksum bytes"

              filename"               要求监视更改或更新的文件的名称。                               

              "{guid}"                文件的全局惟一标识符 (GUID)。                               

              "checksum_bytes"  十六进制数的字符串,表示校验和的字节。必须是偶数位的十六进制数。

                                           奇数位的十六进制数字会致使编译时警告,而后指令被忽略。            

    例子:

复制代码
class TestClass
{
    static int Main()
    {
        #pragma checksum "file.cs" "{3673e4ca-6098-4ec1-890f-8fceb2a794a2}" "{012345678AB}" // New checksum
    }
}
复制代码

  

出处:http://www.cnblogs.com/ck-winner/archive/2013/02/05/2892756.html

===================================================================================

重要说明:

预处理指令都以#号开头并位于行首前面能够出现空格符。

  1. #define DEBUG
  2. #define ISSAY  

上面的语句定义了连个个预编译的符号,他的做用域是他所处整个文件,定义符号的语句必须出如今全部代码以前, 不然编译的时候会出现一个异常: 不能在文件的第一个标记以后,定义或取消定义预处理器符号 。咱们也可使用#undef来取消一个符号的定义,来看个例子。

#define DEBUG
#undef DEBUG
#define ISSAY   
  
using System;   
namespace JustDoIt   
{   
    class Program   
     {   
        static void Main(string[] args)   
         {
             #if DEBUG   
             Console.Write("debug.");
             #endif
             #if ISSAY   
             Console.Write("hello.");
         #else   
             Console.Write("you can say nothing.");
             #endif   
  
         Console.ReadLine();   
         }   
     }   
}   
//输出:hello  

 

==============================================================================================

C#有许多名为预处理器指令的命令。这些命令历来不会被翻译为可执行代码中的命令,但会影响编译过程的各个方面。例如,预处理器可禁止编译器编译代码的某一部分。若是计划发布两个版本的代码,好比基本版本和企业版本,或者针对不一样的.NET Framework版本进行编码,就可使用这些指令。在Anthem.NET的代码中咱们常常能够看到这种用法。

预处理器指令的开头都有符号#。

注意:

C#中并无一个像C++那样的独立预处理器,所谓的预处理器指令仍由编译器处理。

下面将对这些指令逐一介绍。

1. #define和#undef

#define能够定义符号。当将符号用做传递给#if指令的表达式时,此表达式的计算结果true。如

#define DEBUG

它告诉编译器存在给定名称的符号,在本例中是DEBUG。这个符号不是实际代码的一部分,只在编译代码时存在。

#undef正好相反,它删除一个符号。

必须把#define和#undef命令放在C#源码的开头,即在要编译的任何代码以前。它不像C++中那样能够定义常数值。

#define自己并没有大用,它须要配合#if指令使用。

以下代码:

#define DEBUG
 int DoSw(double x)
 {
 #if DEBUG
 COnsole.WriteLine("x is"+X);
 #edif
 }

 

2. #if, #elif, #else和#endif

这些指令告诉编译器是否要编译某个代码块。看下面的方法:

static void PrintVersion()
  {
    #if V3
      Console.WriteLine("Version 3.0");
    #elif V2
      Console.WriteLine("Version 2.0");
    #else
      Console.WriteLine("Version 1.0");
    #endif
  }

 

上面的代码会根据定义的符号来打印不一样的版本信息。 这种方式成为条件编译。

注意:

使用#if不是条件编译代码的惟一方式,C#还提供了经过Conditional属性的机制。

#if和#elif还支持一组逻辑运算符!=,==,!=和|| 。若是符号存在,符号的值被认为是true,不然为false,如:

#if V3 || (V2 == true) // if 定义了V3或V2符号...

3. #warning和#error

这也是两个颇有用的预处理器指令,编译器遇到它们时,会分别产生警告或错误信息。若是遇到#warning指令,会向用户显示#warning指令后面的文本。实际上,在VS2005中,IDE会直接将信息标识出来:

C#预处理器指令

而若是编译器遇到#error,就会当即退出编译,不会产生IL代码。

使用这两个指令能够检查#define是不示作错了什么事,使用#warning可让本身想起作什么事。

#if DEBUG && RELEASE
 #error "You 've define xxxx!"
 #ednif
 #warning "Don't forgot to removexxxxxx!"
 Console.WriteLine("I have this job");

 

4. #region和#endregion

#region和#endregion指令用于把一段代码标记为有指定名称的一个块,以下所示:

#region private methods
  private int x;
  private int y;
  #endregion

 

这两个指令不会影响编译过程。但能够为VS编辑器所识别,从而使得代码显示布局更为清晰。

5. #line

能够用于改变编译器在警告和错误信息中显示的文件的名字和行号信息。若是编写代码时,在把代码发给比编译器前,要使用某些软件包改变键入的代码,玖可使用者个指令,由于这意味着比编译器的报告的行号或文件名与文件中的行号或编译的文件名不匹配。#line指令能够用于恢复这种匹配也可使用语法#line default 把行号恢复默认。

#line 164 "cORE.CS"

#LINE default

6. #pragma,#pragma warning,#pragma checksum

#pragma:为编译器提供特殊的指令,说明如何编译包含杂注的文件。

#pragma warning:可启用或禁用某些警告。

#pragma checksum:生成源文件的校验和,以帮助调试ASP.NET页。

能够抑制或恢复指定的编译警告。与命令行选项不一样,#pragma指令能够在类和方法上执行,对抑制什么警告和抑制的时间进行更精细的控制。

#pragma warning disable 169
 public class Aclass
 {
 int nFiled;
 }

 

#pragma warning restore 169

这些预处理指令详见MSDN:

#if

#else

#elif

#endif

# define

#undef

#warning

#error

#line

#region

#endregion

#pragma

#pragma warning

#pragma checksum

 

出处:http://www.bianceng.cn/Programming/csharp/200910/11700.htm

相关文章
相关标签/搜索