C# Conditional特性有什么用 - 根据编译符号决定是否编译方法

来源:这里教程网 时间:2026-02-21 17:32:40 作者:

Conditional特性用于根据编译符号(如 DEBUG、TRACE 等)来决定是否编译某个方法调用。它常用于控制调试或日志代码的执行,只在特定编译条件下包含这些代码。

作用机制

给方法加上 [Conditional("DEBUG")] 后,该方法的调用将只在定义了对应符号(例如 DEBUG)时才会被编译进最终程序集。如果没有定义,则调用会被完全移除,相当于没有这行代码。

注意:Conditional 特性只能应用于返回类型为 void 的方法。

常见用途

调试输出:只在 DEBUG 模式下调用打印日志 性能追踪:在特定条件下启用性能监控 断言检查:实现自定义的 Assert 方法 示例:

#define DEBUG
using System;
using System.Diagnostics;
class Program
{
    [Conditional("DEBUG")]
    public static void Log(string message)
    {
        Console.WriteLine("[LOG] " + message);
    }
    static void Main()
    {
        Log("程序开始"); // 只有在定义 DEBUG 时才执行
        DoWork();
        Log("程序结束");
    }
    static void DoWork() { }
}

如果去掉 #define DEBUG,所有 Log 调用都会被编译器自动移除,不会产生任何调用开销。

多个条件控制

可以使用多个 Conditional 特性,表示方法在任一符号被定义时都应编译:

[Conditional("DEBUG")]
[Conditional("TRACE_LOG")]
public static void TraceLog(string msg)
{
    Console.WriteLine("[TRACE] " + msg);
}

只要定义了 DEBUG 或 TRACE_LOG,调用就会保留。

基本上就这些。这个特性帮你写出更干净、无运行时判断开销的条件执行代码。

相关推荐

热文推荐