C#のConditional属性（条件付き属性）とは？基本構文と使い方を実例で解説

属性（Attribute）は、プログラムにメタデータを追加するための仕組みです。コンパイラへの指示や、コメント・説明文、メソッドやクラスに関する付加情報などをコードに埋め込むことができます。

Conditional属性とは

Conditional属性は、あらかじめ定義されている属性の一つで、指定したプリプロセッサ識別子（シンボル）が定義されている場合にのみ実行される「条件付きメソッド」をマークします。

この属性を使用すると、Debug や Trace など、指定されたシンボルの値に応じてメソッド呼び出しの条件付きコンパイルが行われます。たとえば、デバッグ中に変数の値を表示したい場合などに活用できます。リリースビルドでは該当するメソッド呼び出しが自動的に除外されるため、本番環境に影響を与えずにデバッグ用のコードを組み込めるのが大きな特徴です。

Conditional属性の構文

Conditional属性は次のように記述します。

[Conditional(
    conditionalSymbol
)]

conditionalSymbol の部分には、#define ディレクティブで定義されたシンボル名を指定します。

使用例

実際にConditional属性を使ったコードを見てみましょう。

#define DEBUG
using System;
using System.Diagnostics;

public class Myclass {
    [Conditional("DEBUG")]

    public static void Message(string msg) {
        Console.WriteLine(msg);
    }
}

class Test {
    static void function1() {
        Myclass.Message("In Function 1");
        function2();
    }

    static void function2() {
        Myclass.Message("In Function 2");
    }

    public static void Main() {
        Myclass.Message("In Main function");
        function1();
        Console.ReadKey();
    }
}

実行結果

In Main function
In Function 1
In Function 2

この例では、#define DEBUG によって DEBUG シンボルが定義されているため、[Conditional("DEBUG"]) を付けた Message メソッドが有効になり、すべてのメッセージが出力されます。

もし #define DEBUG を削除してコンパイルすると、Message メソッドの呼び出しはすべて無視され、何も表示されなくなります。このように、Conditional属性を使えば、デバッグ用の処理をシンプルな記述で制御でき、コードの保守性も向上します。