ylbtech-Docs-.NET-C#-指南-语言参考-预处理器指令:#if 预处理指令 |
1.返回顶部 |
#if(C# 参考)
- 2018/06/30
如果 C# 编译器遇到 #if
指令,最终是 #endif 指令,则仅当定义指定的符号时,它才编译这些指令之间的代码。 与 C 和 C++ 不同,你不能为符号分配数字值。 C# 中的 #if 语句是布尔值,且仅测试是否已定义该符号。 例如:
#if DEBUG Console.WriteLine("Debug version"); #endif
仅可以使用运算符 ==(相等)和 !=(不相等)测试 true 或 false。 True 表示定义该符号。 语句 #if DEBUG
具有与 #if (DEBUG == true)
相同的含义。 可以使用运算符 && (and)、|| (or) 和 ! (not) 评估是否已经定义了多个符号。 还可以用括号对符号和运算符进行分组。
备注
#if
以及 #else、#elif、#endif、#define 和 #undef 指令,允许基于是否存在一个或多个符号包括或排除代码。 这在编译调试版本的代码或编译特定配置的代码时会很有用。
以 #if
指令开头的条件指令必须以 #endif
指令显式终止。
#define
允许你定义一个符号。 然后通过将该符号用作传递给 #if
指令的表达式,该表达式的计算结果为 true
。
还可以通过 -define 编译器选项来定义符号。 可以通过 #undef 取消定义符号。
使用 -define
或 #define
定义的符号与具有相同名称的变量不冲突。 也就是说,变量名称不应传递给预处理器指令,且符号仅能由预处理器指令评估。
使用 #define
创建的符号的作用域是在其中定义它的文件。
此外,生成系统还会感知表示不同目标框架的预定义预处理器符号。 在创建可以面向多个.NET 实现或版本的应用程序时,这些符号会很有用。
.NET Framework | NETFRAMEWORK , NET20 , NET35 , NET40 , NET45 , NET451 , NET452 , NET46 , NET461 , NET462 , NET47 , NET471 , NET472 , NET48 |
.NET Standard | NETSTANDARD , NETSTANDARD1_0 , NETSTANDARD1_1 , NETSTANDARD1_2 , NETSTANDARD1_3 , NETSTANDARD1_4 , NETSTANDARD1_5 , NETSTANDARD1_6 , NETSTANDARD2_0 , NETSTANDARD2_1 |
.NET Core | NETCOREAPP , NETCOREAPP1_0 , NETCOREAPP1_1 , NETCOREAPP2_0 , NETCOREAPP2_1 , NETCOREAPP2_2 , NETCOREAPP3_0 |
其他预定义符号包括 DEBUG 和 TRACE 常量。 你可以使用 #define
替代项目的值集。 例如,会根据生成配置属性(“调试”或者“发布”模式)自动设置 DEBUG 符号。
示例
下例显示如何在文件上定义 MYTEST 符号,然后测试 MYTEST 和 DEBUG 符号的值。 此示例的输出取决于是在“调试”还是“发布”配置模式下生成项目。
#define MYTEST using System; public class MyClass { static void Main() { #if (DEBUG && !MYTEST) Console.WriteLine("DEBUG is defined"); #elif (!DEBUG && MYTEST) Console.WriteLine("MYTEST is defined"); #elif (DEBUG && MYTEST) Console.WriteLine("DEBUG and MYTEST are defined"); #else Console.WriteLine("DEBUG and MYTEST are not defined"); #endif } }
下例显示如何针对不同的目标框架进行测试,以便在可能时使用较新的 API:
public class MyClass { static void Main() { #if NET40 WebClient _client = new WebClient(); #else HttpClient _client = new HttpClient(); #endif } //... }
请参阅
2.返回顶部 |
3.返回顶部 |
4.返回顶部 |
5.返回顶部 |
6.返回顶部 |
作者:ylbtech 出处:http://ylbtech.cnblogs.com/ 本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。 |