C#の事前定義属性（Predefined Attributes）とは？代表的な3種類をわかりやすく解説

C#には、あらかじめ言語側で用意されている「事前定義属性（Predefined Attributes）」が存在します。これらを活用することで、クラスやメソッドに追加情報を付与し、コンパイラの動作を制御できます。

代表的な事前定義属性は、以下の3つです。

• AttributeUsage
• Conditional
• Obsolete

AttributeUsage属性

AttributeUsageは、独自に作成したカスタム属性クラスが「どのように使用できるか」を記述するための属性です。属性を適用できる対象（クラス、メソッド、プロパティなど）や、同一要素への複数回適用の可否などを指定できます。

構文は次のとおりです。

[AttributeUsage (
    validon,
    AllowMultiple = allowmultiple,
    Inherited = inherited
)]

• validon：属性を適用できる言語要素（AttributeTargets）を指定します。
• AllowMultiple：同じ要素に複数回適用できるかどうかをbool値で指定します。
• Inherited：派生クラスへ属性を継承するかどうかをbool値で指定します。

Conditional属性

Conditionalは、条件付きコンパイルを行うメソッドに対して付与される属性です。指定したプリプロセッサ識別子（シンボル）が定義されている場合にのみ、そのメソッド呼び出しがコンパイルされます。

たとえばデバッグビルドでのみ実行したいログ出力処理などに利用され、「Debug」や「Trace」といったシンボルを条件として指定するのが一般的です。

構文は次のとおりです。

[Conditional(
    conditionalSymbol
)]

使用例：

[Conditional("DEBUG")]
public void DebugLog(string message) {
    Console.WriteLine(message);
}

この場合、DEBUGシンボルが定義されている環境でのみ、DebugLogメソッドの呼び出しが有効になります。

Obsolete属性

Obsoleteは、「今後使用すべきではないプログラム要素」に付与する属性です。古くなったAPIなどにこの属性を指定しておくと、その要素を使用したコードに対してコンパイラが警告またはエラーを出力してくれます。

構文は次のとおりです。

[Obsolete (
    message
)]

[Obsolete (
    message,
    iserror
)]

• message：代替手段などを伝えるメッセージ文字列を指定します。
• iserror：trueを指定すると警告ではなくコンパイルエラーになります。falseの場合は警告のみ表示されます。

使用例：

[Obsolete("代わりにNewMethodを使用してください", false)]
public void OldMethod() {
    // 古い処理
}

まとめ

C#の事前定義属性を使いこなすことで、カスタム属性の適用範囲の制御（AttributeUsage）、条件付きコンパイル（Conditional）、非推奨APIの明示（Obsolete）を実現できます。特にライブラリ開発では、Obsoleteによる非推奨通知が保守性向上に大きく役立ちますので、ぜひ活用してみてください。