Conditional(C# 编程指南) - C# 编程指南

返回介绍

Conditional(C# 编程指南)

发布于 2019-11-12 字数3044 浏览 875 评论 0

根据预处理标识符执行方法。Conditional 属性是 ConditionalAttribute 的别名,可应用于方法或属性类。

在本示例中,Conditional 应用于方法以启用或禁用程序特定的诊断信息的显示:

  复制代码
#define TRACE_ON
using System;
using System.Diagnostics;

public class Trace
{
    [Conditional("TRACE_ON")]
    public static void Msg(string msg)
    {
        Console.WriteLine(msg);
    }
}

public class ProgramClass
{
    static void Main()
    {
        Trace.Msg("Now in Main...");
        Console.WriteLine("Done.");
    }
}

如果未定义 TRACE_ON 标识符,则将不会显示跟踪输出。

Conditional 属性经常与 DEBUG 标识符一起使用以启用调试版本的跟踪和日志记录功能(在发行版本中没有这两种功能),如下例所示:

  复制代码
[Conditional("DEBUG")]
static void DebugMethod()
{
}

备注

当调用标记为条件的方法时,指定的预处理符号的存在或不存在决定是否包含或省略此调用。如果定义了该符号,则包含调用;否则省略调用。使用 Conditional 是封闭 #if 和 #endif 内部方法的替代方法,它更整洁、更别致、减少了出错的机会,如下例所示:

  复制代码
#if DEBUG
void ConditionalMethod()
{
}
#endif

条件方法必须是类或结构声明中的方法,而且必须具有 void 返回类型。

使用多个标识符

如果某个方法具有多个 Conditional 属性,且至少定义了多个条件符号(换言之,这些符号彼此之间存在逻辑“或”关系)中的一个,则将包含对该方法的调用。在本例中,A 或 B 的存在将导致方法调用:

C#  复制代码
[Conditional("A"), Conditional("B")]
static void DoIfAorB()
{
    // ...
}

若要获得对符号进行逻辑“与”运算的效果,可以定义序列条件方法。例如,仅当 A 和 B 均已定义时,才能执行下面的第二种方法:

C#  复制代码
[Conditional("A")]
static void DoIfA()
{
    DoIfAandB();
}

[Conditional("B")]
static void DoIfAandB()
{
    // Code to execute when both A and B are defined...
}

使用具有属性类的条件

Conditional 属性还可被应用于属性类定义。在本例中,仅当定义了 DEBUG 时,自定义属性 Documentation 才向元数据添加信息。

C#  复制代码
[Conditional("DEBUG")]
public class Documentation : System.Attribute
{
    string text;

    public Documentation(string text)
    {
        this.text = text;
    }
}

class SampleClass
{
    // This attribute will only be included if DEBUG is defined.
    [Documentation("This method displays an integer.")]
    static void DoWork(int i)
    {
        System.Console.WriteLine(i.ToString());
    }
}

请参见

概念

C# 编程指南

参考

反射(C# 编程指南)属性(C# 编程指南)消除属性目标的歧义性(C# 编程指南)创建自定义属性(C# 编程指南)使用反射访问属性(C# 编程指南)System.ReflectionAttribute

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!