【.NET Core】C#预处理器指令
文章目录
【.NET Core】C#预处理器指令一、概述二、可为空上下文(`#nullable`)三、条件编译2.1 定义DEBUG是编译代码2.2 未定义`MYTEST`时,将编译以下代码 四、定义符号五、定义区域六、错误和警告信息![在这里插入图片描述](http://zhangshiyu.com/zb_users/upload/2024/04/20240415125811171315709143531.jpg)
一、概述
预处理器指令是指编译器在实际编译开始之前对信息进行预处理。通常是简化源程序在不同的环境中运行。尽管编译器没有单独的预处理器,但是本文所说的指令的处理方式与有预处理器时一样。可以使用这些指令来帮助条件编译。不同于C和C++指令,不能使用这些指令来创建宏。预处理器指令必须是一行中唯一的说明。
二、可为空上下文(#nullable
)
#nullable
预处理器指令将设置可为空注释上下文和可为空警告上下文 。 此指令控制是否可为空注释是否有效,以及是否给出为 Null 性警告。 每个上下文要么处于已禁用状态,要么处于已启用状态 。
可在项目级别指定这些两个上下文。#nullable
指令控制注释和警告上下文,并优先于项目级设置。 指令会设置其控制的上下文,直到另一个指令替代它,或直到源文件结束为止。
指令说明如下:
nullable disable
:将可为空注释和警告上下文设置为”已禁用“。#nullable enable
:将可为空注释和警告上下文设置为“已启用”。#nullable restore
:将可为空注释和警告上下文还原为项目设置。#nullable disable annotations
:将可为空注释上下文设置为“已禁用”。#nullable enable annotations
:将可为空注释上下文设置为“已启用”。#nullable restore annotations
:将可为空注释上下文还原为项目设置。#nullable disable warnings
:将可为空警告上下文设置为“已禁用”。#nullable enable warnings
:将可为空警告上下文设置为“已启用”。#nullable restore warnings
:将可为空警告上下文还原为项目设置。 三、条件编译
使用四个预处理器指令来控制条件编译:
#if
:打开条件编译,其中仅在定义了指令的符号时才会编译代码。#elif
:关闭前面的条件编译,并基于是否定义了指定的符号打开一个新的条件编译。#else
:关闭前面的条件编译,如果没有定义前面指定的符号,打开一个新的条件编译。#endif
:关闭前面的条件编译。 仅在定义指定的符号时或者在使用!not运算符时未定义指定的符号时,C#编译器才编译#if
指令和#endif
指令之间的代码。C#中的#if
语句是布尔值,且仅测试是否已定义该符号。
2.1 定义DEBUG是编译代码
#if DEBUG Console.WriteLine("Debug version");#endif
2.2 未定义MYTEST
时,将编译以下代码
#if !MYTEST Console.WriteLine("MYTEST is not defined.");#end if
可以使用运算符==(相等)
和!=(不相等)
老测试bool
值是true还是false。true
表示定义该符号。语句#if DEBUG
具有与#if (DEBUG == true)
相同的含义。可以使用&&(and)
、||(or)
和!(not)
运算符来计算是否已定义多个符号。还可以用括号对符号和运算符进行分组。
#if
以及 #else
、#elif
、#endif
、#define
和 #undef
指令,允许基于是否存在一个或多个符号包括或排除代码。 条件编译在编译调试版本的代码或编译特定配置的代码时会很有用。
以 #if
指令开头的条件指令必须以 #endif
指令显式终止。
#elif
可以创建复合条件指令。 如果之前的 #if
和任何之前的可选 #elif
指令表达式的值都不为 true
,则计算 #elif
表达式。 如果 #elif
表达式计算结果为 true
,编译器将计算 #elif
和下一条件指令间的所有代码。
四、定义符号
使用以下两个预处理器指令来定义或取消定义条件编译的符号:
#define
:定义符号#undef
:取消定义符号 使用 #define
来定义符号。 将符号用作传递给 #if
指令的表达式时,该表达式的计算结果为 true
#define GOYEER#if GOYEER Console.WriteLine("Verbose output version");#endif
#define
指令不能用于声明常量值,这与 C 和 C++ 中的通常做法一样。 C# 中的常量最好定义为类或结构的静态成员。 如果具有多个此类常量,请考虑创建一个单独的“常量”类来容纳它们。
五、定义区域
可以使用以下两个预处理器指令来定义可在大纲中折叠的代码区域:
#region
:启动区域。#endregion
:结束区域 利用#region
,可以指定在使用代码编辑器的大纲功能时可展开或折叠的代码块。在较长的代码文件中,折叠或隐藏一个或多个区域十分便利。
#region GoYeerClass definitionpublic class GoYeerClass{ static void Main() { }}#endregion
#region
块必须通过 #endregion
指令终止。 #region
块不能与 #if
块重叠。 但是,可以将 #region
块嵌套在 #if
块内,或将 #if
块嵌套在 #region
块内。
六、错误和警告信息
使用以下指令指示编译器生成用户定义的编译器错误和警告,并控制行信息:
#error
:使用指定的消息生成编译器错误。#warning
:使用指定的消息生成编译器警告。#line
:更改用编译器消息输出的行号。 class MainClass{ static void Main() {#line 200 "Special" int i; int j;#line default char c; float f;#line hidden // numbering not affected string s; double d; }}
控制台输出结果:
Special(200,13): warning CS0168: The variable 'i' is declared but never usedSpecial(201,13): warning CS0168: The variable 'j' is declared but never usedMainClass.cs(9,14): warning CS0168: The variable 'c' is declared but never usedMainClass.cs(10,15): warning CS0168: The variable 'f' is declared but never usedMainClass.cs(12,16): warning CS0168: The variable 's' is declared but never usedMainClass.cs(13,16): warning CS0168: The variable 'd' is declared but never used