C#を用いたアプリケーション開発において、コードに対して付加的な情報を与える「属性（Attribute）」は、プログラムの振る舞いを制御したり、メタデータを記述したりするために欠かせない機能です。

属性は単なるコメントとは異なり、コンパイラや実行時のランタイム、あるいは特定のライブラリに対して、そのコード要素がどのように扱われるべきかを明示的に指示する役割を持ちます。

この記事では、C#における属性の基礎知識から、標準で用意されている便利な属性の使い方、さらには独自の「カスタム属性」を作成して活用する方法までを詳しく解説します。

最新のC#の仕様に基づいた高度なテクニックも紹介しますので、ぜひ最後までご覧ください。

目次 [ close ]
  1. C#における属性（Attribute）とは
    1. 属性の主な役割
  2. 属性の基本構文
    1. 基本的な書き方
    2. 引数を持つ属性
    3. 属性の対象（Attribute Target）を明示する
  3. よく使われる標準属性
    1. [Obsolete] 属性
    2. [Conditional] 属性
    3. [Flags] 属性
    4. [Serializable] と [NonSerialized]
  4. 呼び出し元情報の取得属性（Caller Information Attributes）
  5. カスタム属性の作成方法
    1. 1. 属性クラスの定義
    2. 2. [AttributeUsage] 属性による制限
    3. 3. カスタム属性の使用
  6. リフレクションを用いた属性の読み取り
    1. 属性情報の取得例
  7. ジェネリック属性（C# 11以降の新機能）
  8. 属性を活用するメリットと注意点
    1. メリット
    2. 注意点とデメリット
  9. 実践的な活用シーン
    1. 1. 入力値バリデーション
    2. 2. JSONシリアライズの制御
    3. 3. テストのマーキング
  10. まとめ

C#における属性（Attribute）とは

C#の属性とは、クラス、メソッド、プロパティなどのプログラム要素に対して付加できる「宣言的情報（メタデータ）」のことです。

属性を使用することで、コードのロジックそのものとは別に、そのコードがどのような特性を持つのか、あるいはどのように実行されるべきかという情報を記述できます。

属性に記述された情報は、コンパイル時にアセンブリ内のメタデータとして埋め込まれます。

この情報は、コンパイラがビルド時に参照するだけでなく、実行時に「リフレクション（Reflection）」という仕組みを利用して読み取ることが可能です。

属性の主な役割

属性が活用されるシーンは多岐にわたりますが、代表的なものには以下のような例があります。

  • コンパイラへの指示：特定のメソッドが古いことを警告したり、条件付きコンパイルを行ったりします。
  • 実行時の振る舞いの制御：シリアライズの対象外にする、あるいはデータベースのテーブル名とマッピングさせるといった指定を行います。
  • テストフレームワークとの連携：ユニットテストにおいて、どのメソッドがテスト用であるかを識別するために使用されます。
  • 依存性の注入（DI）：特定のプロパティに対して自動的にインスタンスを注入するためのマーカーとして機能します。

属性の基本構文

属性は、対象となる要素の直前に [] (角括弧) で囲んで記述します。

基本的な書き方

属性を指定する際の最もシンプルな形式は以下の通りです。

C#
[Serializable]
public class MyData
{
    // クラス全体をシリアライズ可能としてマーク
}

属性クラスの名前が Attribute で終わる場合（例：SerializableAttribute）、C#の慣習として末尾の Attribute を省略して記述することが可能です。

引数を持つ属性

属性には、コンストラクタに渡す「位置指定引数」と、公開されているプロパティやフィールドに値を設定する「名前付き引数」があります。

C#
// "message" が位置指定引数、"IsError" が名前付き引数
[Obsolete("このメソッドは非推奨です。NewMethodを使用してください。", IsError = false)]
public void OldMethod()
{
    // 処理
}

位置指定引数は属性のコンストラクタの引数順に記述し、名前付き引数は プロパティ名 = 値 の形式で記述します。

属性の対象（Attribute Target）を明示する

通常、属性はその直後の要素に適用されますが、明示的に適用対象を指定することもできます。

特に、プロパティに対して適用する場合に、バッキングフィールドやアクセサ（get/set）のどちらに適用するかを区別する際に役立ちます。

ターゲット説明
assemblyアセンブリ全体に適用
moduleモジュール全体に適用
typeクラス、構造体、列挙型などに適用
methodメソッドに適用
propertyプロパティに適用
fieldフィールドに適用
eventイベントに適用
paramメソッドの引数に適用
return戻り値に適用
C#
[assembly: AssemblyTitle("MyApplication")]
[return: MarshalAs(UnmanagedType.Bool)]
public bool MyMethod([In, Out] ref int val) { ... }

よく使われる標準属性

.NETのクラスライブラリには、あらかじめ多くの便利な属性が用意されています。

ここでは、開発現場で頻繁に利用される代表的な標準属性を紹介します。

[Obsolete] 属性

コードのメンテナンスにおいて非常に重要な属性です。

特定のクラスやメソッドを「非推奨」としてマークし、利用者に警告やエラーを通知します。

C#
using System;

public class Sample
{
    // 第2引数を true にすると警告ではなくコンパイルエラーになる
    [Obsolete("このメソッドは古いバージョン用です。NextGenMethod() を使用してください。")]
    public void LegacyMethod()
    {
        Console.WriteLine("古い処理を実行しました。");
    }

    public void NextGenMethod()
    {
        Console.WriteLine("最新の処理を実行しました。");
    }
}

class Program
{
    static void Main()
    {
        Sample s = new Sample();
        s.LegacyMethod(); // ここでコンパイラが警告を出す
    }
}

[Conditional] 属性

特定のシンボル（プリプロセッサ演算子）が定義されている場合のみ、メソッドの呼び出しを有効にします。

主に、デバッグ時のみログを出力したいといった用途に便利です。

C#
using System;
using System.Diagnostics;

public class DebugLogger
{
    // DEBUG シンボルが定義されている時だけ実行される
    [Conditional("DEBUG")]
    public static void Log(string message)
    {
        Console.WriteLine($"[DEBUG]: {message}");
    }
}

この属性が付与されたメソッドは、リリースビルド（DEBUGシンボルがない状態）では呼び出しコード自体がコンパイラによって削除されるため、パフォーマンスへの影響を最小限に抑えられます。

[Flags] 属性

列挙型（enum）をビットフラグとして扱う場合に指定します。

これを指定することで、ToString() メソッドの出力結果がビットの組み合わせを考慮したものになります。

C#
using System;

[Flags]
public enum Permissions
{
    None = 0,
    Read = 1,
    Write = 2,
    Execute = 4,
    FullControl = Read | Write | Execute
}

class Program
{
    static void Main()
    {
        Permissions p = Permissions.Read | Permissions.Write;
        // Flags属性があると "Read, Write" と出力される（無いと 3 と出力される）
        Console.WriteLine(p); 
    }
}

[Serializable] と [NonSerialized]

オブジェクトの状態をバイナリやXMLなどに保存・復元できるようにするために、クラスに [Serializable] を付与します。

特定のフィールドをシリアライズの対象から外したい場合は [NonSerialized] を使用します。

呼び出し元情報の取得属性（Caller Information Attributes）

C# 5.0で導入され、ログ出力やMVVMパターンでの通知処理で多用される属性群です。

これらはメソッドの引数に指定することで、「誰がそのメソッドを呼んだか」という情報をコンパイラが自動的に挿入してくれます。

  • [CallerMemberName]：呼び出し元のメソッド名やプロパティ名。
  • [CallerFilePath]：呼び出し元のソースファイルパス。
  • [CallerLineNumber]：呼び出し元の行番号。
C#
using System;
using System.Runtime.CompilerServices;

public class Logger
{
    public void Trace(string message,
        [CallerMemberName] string memberName = "",
        [CallerFilePath] string sourceFilePath = "",
        [CallerLineNumber] int sourceLineNumber = 0)
    {
        Console.WriteLine($"Message: {message}");
        Console.WriteLine($"Member Name: {memberName}");
        Console.WriteLine($"File Path: {sourceFilePath}");
        Console.WriteLine($"Line Number: {sourceLineNumber}");
    }
}

class Program
{
    static void Main()
    {
        var logger = new Logger();
        logger.Trace("プログラム実行中"); 
    }
}

このコードを実行すると、Main メソッドから呼ばれたことや、ファイルパス、行番号が自動的に出力されます。

引数にデフォルト値（"" や 0）を設定しておく必要がある点に注意してください。

カスタム属性の作成方法

標準属性だけでなく、自分で独自の属性を作成することも可能です。

これにより、アプリケーション固有のルールやロジックを宣言的に記述できるようになります。

1. 属性クラスの定義

カスタム属性を作成するには、System.Attribute クラスを継承したクラスを作成します。

C#
using System;

// 属性自体の使い方を制限する AttributeUsage 属性
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true)]
public class AuthorAttribute : Attribute
{
    public string Name { get; }
    public string Version { get; set; }

    public AuthorAttribute(string name)
    {
        this.Name = name;
        this.Version = "1.0";
    }
}

2. [AttributeUsage] 属性による制限

カスタム属性を定義する際には、その属性が「どこに適用できるか」を [AttributeUsage] で制御するのが一般的です。

  • ValidOn：適用可能なターゲット（クラス、メソッドなど）を指定。
  • AllowMultiple：同じ要素に対して、その属性を複数回指定できるかどうか。
  • Inherited：派生クラスに属性が引き継がれるかどうか。

3. カスタム属性の使用

定義した属性は、標準属性と同じように使用できます。

C#
[Author("Tanaka", Version = "1.1")]
[Author("Sato")] // AllowMultiple = true なので複数指定可能
public class MyBusinessLogic
{
    // ロジック
}

リフレクションを用いた属性の読み取り

属性を付与しただけでは、プログラムの動作は変わりません。

付与された情報を読み取って何らかの処理を行うためには、「リフレクション」を使用します。

属性情報の取得例

以下のサンプルコードでは、クラスに付与された AuthorAttribute の情報を実行時に取得しています。

C#
using System;
using System.Reflection;

class Program
{
    static void Main()
    {
        Type type = typeof(MyBusinessLogic);
        // AuthorAttribute をすべて取得
        object[] attributes = type.GetCustomAttributes(typeof(AuthorAttribute), false);

        foreach (AuthorAttribute attr in attributes)
        {
            Console.WriteLine($"作成者: {attr.Name}, バージョン: {attr.Version}");
        }
    }
}
実行結果
作成者: Tanaka, バージョン: 1.1
作成者: Sato, バージョン: 1.0

このように、リフレクションを用いることで、ソースコード内のメタデータを実行時のロジックに反映させることができます。

例えば「特定の属性が付いているメソッドだけを自動実行する」といったプラグイン機構も、この仕組みで実現可能です。

ジェネリック属性（C# 11以降の新機能）

C# 11からは、属性クラスをジェネリックにすることができるようになりました。

これにより、型情報を属性の引数としてより安全かつ簡潔に渡すことが可能になります。

以前は型情報を渡すために typeof(T) を引数に渡す必要がありましたが、ジェネリック属性を使うと以下のように記述できます。

C#
// C# 11 以降：ジェネリック属性の定義
public class ValidatorAttribute<T> : Attribute where T : IValidator
{
    public T Validator { get; }
    public ValidatorAttribute()
    {
        // 実際には実行時にインスタンス化するなどの処理が必要
    }
}

// 使用例
[Validator<UserValidator>]
public class UserProfile
{
    // ...
}

この機能により、型安全性が向上し、コードの記述も直感的になります。

最新のプロジェクトでは積極的に活用を検討すべき機能です。

属性を活用するメリットと注意点

メリット

  1. コードの可読性向上：設定情報をロジックから分離し、宣言的に記述できるため、意図が伝わりやすくなります。
  2. 再利用性の向上：共通の処理（バリデーションやログ出力など）を属性に集約することで、複数の場所で使い回せます。
  3. 結合度の低下：リフレクションを介して疎結合な設計を実現できます。

注意点とデメリット

  1. パフォーマンスのオーバーヘッド：実行時にリフレクションを用いて属性を解析する場合、通常のメソッド呼び出しよりも処理速度が低下します。頻繁に呼ばれるループ内での使用には注意が必要です。
  2. 静的なチェックの限界：属性に渡す引数は定数（コンパイル時定数）である必要があるため、動的な値を渡すことはできません。
  3. 過剰な使用：何でも属性で解決しようとすると、コードのフローが隠蔽されすぎてしまい、デバッグが困難になることがあります。

実践的な活用シーン

属性を使いこなすための実践的な例をいくつか挙げます。

1. 入力値バリデーション

ASP.NET CoreなどのWebフレームワークでは、モデルのプロパティに属性を付与することで、自動的にバリデーションを行う仕組みが備わっています。

C#
public class UserRegistration
{
    [Required]
    [StringLength(20, MinimumLength = 3)]
    public string Username { get; set; }

    [EmailAddress]
    public string Email { get; set; }
}

2. JSONシリアライズの制御

System.Text.Json を使用する際、プロパティ名をカスタマイズしたり、特定の項目を除外したりするために属性が使われます。

C#
public class Product
{
    [JsonPropertyName("product_name")]
    public string Name { get; set; }

    [JsonIgnore]
    public decimal InternalCost { get; set; }
}

3. テストのマーキング

xUnitやNUnitといったユニットテストフレームワークでは、どのメソッドがテストケースであるかを判断するために属性を使用します。

C#
[Fact]
public void Test_Addition()
{
    Assert.Equal(4, 2 + 2);
}

まとめ

C#の属性（Attribute）は、プログラムにメタデータを付与し、コードの意図をコンパイラや実行環境に伝える強力な手段です。

  • 標準属性を使うことで、非推奨コードの警告や条件付きコンパイル、ビットフラグの管理が容易になります。
  • カスタム属性を作成すれば、アプリケーション独自のルールを宣言的に記述でき、保守性の高いコードを実現できます。
  • リフレクションと組み合わせることで、実行時に動的な処理の切り替えが可能になります。
  • ジェネリック属性（C# 11〜）などの最新機能を活用することで、より型安全なコーディングが可能になります。

属性を適切に使いこなすことは、C#エンジニアとしてステップアップするための重要な鍵となります。

まずは身近な標準属性から使い始め、徐々にカスタム属性による共通化やリフレクションの活用へと幅を広げてみてください。