C#で属性（Attribute）を操作する方法をわかりやすく解説

属性（Attribute）とは、クラス、メソッド、構造体、列挙型、アセンブリなど、プログラム内のさまざまな要素の動作に関する情報を、宣言的にランタイムへ伝えるためのタグです。属性を使用することで、コードに宣言的な情報（メタデータ）を追加できます。

宣言タグは、対象となる要素の直上に角括弧 [ ] を付けて記述します。コンパイルされた属性情報は、実行時にリフレクション（Reflection）を使って取得・参照することが可能です。

属性の基本構文

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

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

位置パラメータ（positional_parameters）は必須の引数、名前付きパラメータ（name_parameter = value）は省略可能な設定値を表します。複数のパラメータを指定する場合はカンマで区切ります。

属性の種類

.NET Framework では、次の2種類の属性が利用できます。

• 定義済み属性（Pre-defined Attributes）：フレームワークにあらかじめ用意されている属性。たとえば [Obsolete] や [Serializable] などがあります。
• カスタム属性（Custom Attributes）：開発者が独自の目的に合わせて定義する属性。System.Attribute クラスを継承して作成します。

カスタム属性の宣言方法

独自の属性を作成するには、System.Attribute を継承したクラスを定義します。その際、AttributeUsage 属性を使って、その属性をどの要素に適用できるかを指定できます。

以下は、クラスおよびそのメンバーに割り当てるカスタム属性「BugFix」の宣言例です。

// クラスおよびそのメンバーに割り当てるカスタム属性 BugFix
[AttributeUsage(
    AttributeTargets.Class |
    AttributeTargets.Constructor |
    AttributeTargets.Field |
    AttributeTargets.Method |
    AttributeTargets.Property,
    AllowMultiple = true)]
public class DeBugInfo : System.Attribute
{
}

この例では、AttributeTargets のフラグをビット演算子 | で組み合わせることで、クラス、コンストラクター、フィールド、メソッド、プロパティに対してこの属性を適用できるようにしています。また、AllowMultiple = true を指定することで、同じ要素に同じ属性を複数回適用できるようになります。

まとめ

属性は、コードの動作自体を変えるものではなく、ランタイムやツールに対して補足情報を与えるための仕組みです。定義済み属性を活用しつつ、必要に応じてカスタム属性を作成することで、より柔軟で保守性の高いプログラムを実現できます。