• C# 预处理器指令


    介绍

    预处理指令是由编译器解释的命令,并影响输出或生成过程中的行为. 使用术语“预处理指令”只是为了与 C 和 C++ 编程语言保持一致。在 C# 中没有单独的预处理步骤,不像C和C++中,你不可以使用这些指令创建宏。预处理指令总是占用源代码中的单独一行,并且总是以 # 字符和预处理指令名称开头。# 字符的前面以及 # 字符与指令名称之间可以出现空白符。

    接下来我们看看有关以下 C# 预处理器指令的信息:

    #IF

    如果 C# 编译器遇到最后面跟有 #endif 指令的 #if 指令,则仅当指定的符号已定义时,它才会编译这两个指令之间的代码。
    C# 中的 #if 语句是 Boolean,仅测试符号是否已定义。
    运算符 &&(与)和 ||(或)可用来评估多个符号是否已定义。 还可以用括号将符号和运算符分组。
    结合使用 #if 与 #else、#elif、#endif、#define 和 #undef 指令,可以根据一个或多个符号是否存在来包含或排除代码。在编译调试版本的代码或针对特定配置进行编译时,这会很有用。
    以 #if 指令开始的条件指令必须用 #endif 指令显式终止。

    #Else

    #else 允许您创建复合条件指令,因此,如果前面的 #if 或(可选)#elif 指令中的任何表达式都不为 true,则编译器将计算 #else 与后面的 #endif 之间的所有代码。

    #Elif

    #elif 使您得以创建复合条件指令。如果前面的 #if 和前面的任何 #elif(可选)指令表达式的计算结果都不是 true,则将计算 #elif 表达式。如果 #elif 表达式计算为 true,编译器将计算位于 #elif 和下一个条件指令之间的所有代码。
    使用 #elif 更简单,因为每个 #if 都需要一个 #endif,而 #elif 即使在没有匹配的 #endif 时也可以使用。

    #Endif

    #endif 指定以 #if 指令开头的条件指令的结尾

    #Define

    #define 可让您定义符号。 当您将符号用作传递给 #if 指令的表达式时,此表达式的计算结果为 true

    注意:不能像在 C 和 C++ 中的通常做法一样,使用 #define 指令来声明常数值。最好是将 C# 中的常数定义为类或结构的静态成员。如果具有多个像这样的常数,可以考虑创建一个单独的“Constants”类来保存这些常数。

    针对以上指令我们提供一段代码:

    如上所示:由于DEBUG 和 MYTEST都定义了,所以,如下代码

    #elif (DEBUG && MYTEST)
    Console.WriteLine("DEBUG and MYTEST are defined");

    高亮显示可用,其他行代码置灰。

    运行结果:

    #Undef
    #undef 使您可以取消符号的定义,以便通过将该符号用作 #if 指令中的表达式,使表达式的计算结果为 false。

    示例代码:

    #define DEBUG
    #undef DEBUG
    using System;
    class MyClass
    {
        static void Main()
        {
    #if DEBUG
            Console.WriteLine("DEBUG is defined");
    #else
            Console.WriteLine("DEBUG is not defined");
    #endif
        }
    }

    运行结果:

    #Warning
    #warning 使您得以从代码的特定位置生成一级警告。 例如:

    #define DEBUG
    class MainClass
    {
        static void Main()
        {
    #if DEBUG
    #warning DEBUG is defined
    #endif
        }
    }

    #Error 

    #error使您可以从代码中的特定位置生成错误。例如:

    #define DEBUG
    class MainClass
    {
        static void Main()
        {
    #if DEBUG
    #error DEBUG is defined
    #endif
        }
    }

    #Region

    #region 是大家最为熟悉的指令,它使您可以在使用 Visual Studio 代码编辑器的大纲显示功能时指定可展开或折叠的代码块。 在较长的代码文件中,能够折叠或隐藏一个或多个区域会十分便利,这样,您可将精力集中于当前处理的文件部分。 下面的示例演示如何定义区域:

    #region MyClass definition
    public class MyClass
    {
        static void Main()
        {
        }
    }
    #endregion

    #region 块必须以 #endregion 指令终止。
    #region 块不能与 #if 块重叠。但是,可以将 #region 块嵌套在 #if 块内,或将 #if 块嵌套在 #region 块内。

    #endregion

    #endregion 标记 #region 块的结尾

    #line
    #line 使您可以修改编译器的行号以及(可选)错误和警告的文件名输出。 下面的示例说明如何报告与行号关联的两个警告。 #line 200 指令将行号强制设置为 200(尽管默认行号为 #7),在执行下一条 #line 指令之前,文件名将报告为“Special”。 #line default 指令将行号恢复为默认行号,默认行号对前一条指令重新编号的行进行计数。

    输出结果:

    备注
    #line 指令可能由生成过程中的自动中间步骤使用。例如,如果行从原始的源代码文件中移除,但是您仍希望编译器基于文件中的原始行号生成输出,则可以移除行,然后用 #line 模拟原始行号。
    #line hidden 指令对调试器隐藏若干连续的行,这样当开发人员在逐句通过代码时,将会跳过 #line hidden 和下一个 #line 指令(假定它不是另一个 #line hidden 指令)之间的所有行。此选项也可用来使 ASP.NET 能够区分用户定义的代码和计算机生成的代码。尽管 ASP.NET 是此功能的主要使用者,但很可能将有更多的源生成器使用它。
    #line hidden 指令不会影响错误报告中的文件名或行号。即,如果在隐藏块中遇到错误,编译器将报告当前文件名和错误的行号。
    #line filename 指令指定您希望出现在编译器输出中的文件名。默认情况下,使用源代码文件的实际名称。文件名必须用双引号 ("") 引起来且前面必须带一个行号。
    源代码文件可以具有 #line 指令的任何编号。

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

    #pragma

    #pragma 为编译器提供特殊的指令,以说明如何编译包含杂注的文件。 这些指令必须是编译器支持的指令。 也就是说,不能使用 #pragma 创建自定义预处理指令。Microsoft C# 编译器支持以下两个 #pragma 指令:
    #pragma warning
    #pragma checksum

    在日常开发的过程中我们总是会经常对代码进行编译,而在编译的过程中会出现许多信息,许多无用的警告信息总是会在编译过程中提示出来,以干扰一些主要的警告,对此也是可以通过预处理器指令来进行关闭来阻止其显示。


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

    在创建的项目中,打开“输出”窗口(这样可以查看输出的警告编号:如(CS0414)):Debug->Windows->Output,如下图所示:

     

    然后我们做个测试:

    using System;
    class MainClass
    {
        static void Main()
        {
            int i = 5;
            Console.ReadLine();
        }
    }
    
    public class test
    {
        int i = 10;
    }

    对于如上代码,经过编译后出现如下类似警告:“变量i被分配,但从来没有使用过它的值”。

    如果我们不想显示这些警告,可通过:#pragma warning disable 警告编号1, 警告编号2,来消除。
    如上图所示,警告编号分别为CS0219,CS0414
    注意:消除的编号不带”CS”,如下代码:

    #pragma warning disable 0219,0414
    using System;
    class MainClass
    {
        static void Main()
        {
            int i = 5;
            Console.ReadLine();
        }
    }
    
    public class test
    {
        int i = 10;
    }

    编译项目查看输出结果:

    没有警告了。

    如果我们又想显示CS0414怎么办呢?
    可以使用#pragma warning restore 警告编号1
    如下代码:

    #pragma warning disable 0219,0414
    using System;
    class MainClass
    {
        static void Main()
        {
            int i = 5;
            Console.ReadLine();
        }
    }
    #pragma warning restore 0414
    public class test
    {
        int i = 10;
    }

    编译项目,查看输出结果:

    CS0414警告又显示出来了。

    #pragma checksum

    关于#pragma checksum指令我没能理解,google了一下也没找到相关示例。

    这里给出MSDN链接:http://msdn.microsoft.com/zh-cn/library/vstudio/ms173226.aspx

    大家可以自行参考,希望熟悉的朋友可以给出解释和示例,帮助大家。

  • 相关阅读:
    Windows Phone自学笔记(2)
    对MVC的初步认识
    CMSIS 的相关知识
    关于机器码的一些疑惑
    关于预编译处理的尝试
    IAR提示错误C:\Program Files\IAR Systems\Embedded Workbench 6.4 Kickstart\arm\bin路径下的armjlink.dll文件
    Spring学习笔记(四)
    Spring学习笔记(三)
    Docker容器数据卷(v创建数据卷)
    Spring5学习笔记(一)
  • 原文地址:https://www.cnblogs.com/zhangzhi19861216/p/2997635.html
Copyright © 2020-2023  润新知