C#の属性（Attribute）とは？基本構文と主な定義済み属性をわかりやすく解説

C#における属性（Attribute）とは、クラス、メソッド、構造体、列挙型、アセンブリなど、プログラムを構成するさまざまな要素の動作に関する情報を、実行時（ランタイム）に伝えるための宣言型のタグです。

属性を使うことで、コード自体には手を加えずに、追加のメタデータを要素へ付与することができます。

属性の基本構文

属性は以下のような形式で記述します。

[attribute(positional_parameters, name_parameter = value, ...)]
Element

この構文のポイントは次のとおりです。

• 属性名とその値は角括弧 [ ] の中に記述します。
• 属性は、適用対象となる要素の直前に置きます。
• 位置パラメータ（positional parameters）は、必ず指定しなければならない必須情報を表します。
• 名前付きパラメータ（name parameters）は、省略可能な追加情報を「名前 = 値」の形式で指定します。

C#で用意されている主な定義済み属性

C#には、あらかじめ用意された便利な属性がいくつか存在します。ここでは代表的な3つを紹介します。

1. AttributeUsage

AttributeUsageは、独自に作成したカスタム属性クラスが「どのように使われるべきか」を記述するための定義済み属性です。たとえば、その属性をクラスにのみ適用できるのか、メソッドにも使えるのかといった適用範囲を制御できます。

2. Conditional

Conditionalは、条件付きメソッドをマークするための属性です。この属性が付けられたメソッドは、指定されたプリプロセッサ識別子（シンボル）が定義されている場合にのみ実行されます。デバッグ用のログ出力などを切り替えたい場合によく利用されます。

3. Obsolete

Obsoleteは、「今後使用すべきではないプログラム要素」をマークするための属性です。古くなったAPIなどにこの属性を付けておくと、コンパイラに対してその要素の使用を警告またはエラーとして通知できるため、開発者に非推奨であることを明確に伝えられます。

[Obsolete("このメソッドは非推奨です。NewMethod() を使用してください。")]
public void OldMethod()
{
    // 処理内容
}

このように属性を活用することで、コードの意図を明確にし、保守性の高いプログラムを作成することができます。