#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、

1、

https://docs.microsoft.com/zh-cn/dotnet/csharp/language-reference/preprocessor-directives/preprocessor-if

2、

6.返回顶部

作者：ylbtech
出处：http://ylbtech.cnblogs.com/
本文版权归作者和博客园共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。