C#を用いたアプリケーション開発において、コードの挙動を制御したり、付加的な情報を付与したりするために欠かせないのが「属性（Attribute）」という機能です。

属性を適切に使いこなすことで、ソースコードの可読性を高めるだけでなく、共通処理の自動化やボイラープレートコード（定型文的なコード）の削減が可能になります。

本記事では、C#における属性の基礎知識から、開発現場ですぐに役立つ実践的な使いどころ、さらには独自の属性を定義する方法までを詳しく解説します。

最新の.NET環境における標準的な活用シーンを理解し、より洗練されたプログラミング手法を身に付けていきましょう。

目次 [ close ]
  1. C#における属性の基本概念
    1. 属性の記述方法
  2. 開発現場で頻出する標準属性の使いどころ
    1. 1. コードの移行を促す [Obsolete]
    2. 2. 条件付き実行を制御する [Conditional]
    3. 3. 呼び出し元の情報を取得する [CallerMemberName]
  3. Webアプリ・API開発における属性の活用シーン
    1. 入力バリデーション（Data Annotations）
    2. ルーティングとHTTP動詞の指定
  4. JSON・データベースのマッピング制御
    1. System.Text.Json によるシリアライズ制御
    2. Entity Framework Core (EF Core) によるO/Rマッピング
  5. カスタム属性の作成と実装方法
    1. 1. 属性クラスの定義
    2. 2. 属性の利用
    3. 3. リフレクションによる属性の読み取り
  6. 属性を使用する際の注意点とベストプラクティス
    1. パフォーマンスへの影響
    2. 属性には「ロジック」を書かない
    3. 依存関係に注意する
  7. まとめ

C#における属性の基本概念

属性とは、プログラムの要素（クラス、メソッド、プロパティ、アセンブリなど）に対して宣言的なメタデータを付与するための仕組みです。

通常のコードが「どのように処理を行うか」を記述するのに対し、属性は「その要素がどのような性質を持っているか」を記述するために使用されます。

属性の最大の特徴は、付与したメタデータをリフレクション（Reflection）やソースジェネレーター（Source Generators）といった技術を用いて、実行時やコンパイル時に読み取ることができる点にあります。

これにより、コードそのものにロジックを書き込むことなく、特定のフレームワークやツールに対して「このメソッドはWeb APIのエンドポイントである」「このプロパティはデータベースの主キーである」といった指示を出すことができます。

属性の記述方法

C#で属性を使用する際は、対象となる要素の直前に角括弧 [] で囲んで記述します。

属性クラスの名前が ExampleAttribute である場合、末尾の Attribute を省略して [Example] と書くのが一般的です。

C#
// クラスに対して属性を付与する例
[Serializable]
public class UserData
{
    // プロパティに対して属性を付与する例
    [Required]
    public string UserName { get; set; }

    // メソッドに対して属性を付与する例
    [Obsolete("このメソッドは古いバージョンです。NewMethodを使用してください。")]
    public void OldMethod()
    {
        // 処理内容
    }
}

このように、属性はプログラムの構造に対して補足情報を「ラベル」のように貼り付けるイメージで利用します。

開発現場で頻出する標準属性の使いどころ

C#（.NET）には、標準ライブラリの中で数多くの属性が用意されています。

これらを効果的に使うことで、バグの抑制やメンテナンス性の向上に寄与します。

1. コードの移行を促す [Obsolete]

長期的なプロジェクトでは、既存のメソッドを廃止し、新しい実装に置き換えたい場面が多々あります。

しかし、いきなり削除すると他のチームのコードがコンパイルエラーになってしまいます。

そこで活躍するのが [Obsolete] 属性です。

この属性を付与されたメソッドを使用しようとすると、コンパイラが警告（Warning）を出します。

また、引数に true を渡すことで、警告ではなくコンパイルエラーとして扱うことも可能です。

C#
public class Calculator
{
    // 警告を表示する
    [Obsolete("Add(int, int) は非推奨です。Sum(params int[]) を使用してください。")]
    public int Add(int a, int b) => a + b;

    // 強制的にエラーにする
    [Obsolete("このメソッドは削除されました。", true)]
    public void DeletedMethod() { }
}

2. 条件付き実行を制御する [Conditional]

デバッグ時のみログを出力したい、あるいは特定のシンボル（DEBUGなど）が定義されている場合のみメソッドを実行したい場合には、[Conditional] 属性が便利です。

この属性の利点は、呼び出し元を修正することなく、コンパイル結果からメソッドの呼び出し自体を除去できる点にあります。

これにより、リリースビルドのパフォーマンスを損なうことなく、デバッグ用のコードを埋め込むことができます。

C#
using System.Diagnostics;

public class Logger
{
    // DEBUGシンボルが定義されている場合のみ実行される
    [Conditional("DEBUG")]
    public static void LogDebug(string message)
    {
        Console.WriteLine($"[DEBUG]: {message}");
    }
}

3. 呼び出し元の情報を取得する [CallerMemberName]

ログ出力や INotifyPropertyChanged の実装において、どのメソッドから呼び出されたかを知りたいことがあります。

従来はリフレクションでスタックトレースを解析していましたが、現在は [CallerMemberName] 属性を使用することで、コンパイル時に呼び出し元の名前を自動注入できます。

C#
using System.Runtime.CompilerServices;

public class NotifyBase
{
    protected void OnPropertyChanged([CallerMemberName] string propertyName = "")
    {
        Console.WriteLine($"プロパティ変更: {propertyName}");
    }
}

Webアプリ・API開発における属性の活用シーン

モダンなWeb開発（ASP.NET Core）において、属性はフレームワークの核となる役割を果たしています。

入力バリデーション（Data Annotations）

ユーザーから送られてきたデータが正しい形式かどうかをチェックする際、if文を羅列する代わりに System.ComponentModel.DataAnnotations 名前空間の属性を使用します。

これを 宣言的バリデーション と呼びます。

属性名説明
[Required]必須入力項目であることを指定する
[StringLength]文字列の最大・最小長を制限する
[Range]数値の範囲を制限する
[EmailAddress]メールの形式であることをチェックする
[RegularExpression]正規表現によるカスタムバリデーションを行う
C#
public class UserRegistrationModel
{
    [Required(ErrorMessage = "ユーザー名は必須です")]
    [StringLength(20, MinimumLength = 3)]
    public string UserName { get; set; }

    [Range(18, 99)]
    public int Age { get; set; }

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

ルーティングとHTTP動詞の指定

ASP.NET Core MVCやWeb APIでは、どのURLに対してどのメソッドを対応させるかを属性で指定します。

これにより、URL設計とコードの対応関係が一目で理解できるようになります。

C#
[ApiController]
[Route("api/[controller]")]
public class ProductsController : ControllerBase
{
    [HttpGet("{id}")]
    public IActionResult GetProduct(int id)
    {
        // 処理
        return Ok();
    }

    [HttpPost]
    [Authorize(Roles = "Admin")] // 権限チェックも属性で行う
    public IActionResult CreateProduct([FromBody] Product product)
    {
        // 処理
        return CreatedAtAction(nameof(GetProduct), new { id = 1 }, product);
    }
}

上記のように、[Authorize] 属性を付与するだけで、特定の権限を持つユーザーのみにアクセスを制限できるなど、アスペクト指向プログラミング（AOP）的な使い方ができるのも属性の強みです。

JSON・データベースのマッピング制御

外部システムとのデータ連携やデータベース保存時にも、属性は極めて重要な役割を担います。

System.Text.Json によるシリアライズ制御

C#のプロパティ名と、外部APIのJSONキー名が異なる場合、属性を使ってマッピングを定義します。

C#
using System.Text.Json.Serialization;

public class WeatherInfo
{
    [JsonPropertyName("temp_c")] // JSON側のキー名を指定
    public double TemperatureCelsius { get; set; }

    [JsonIgnore] // このプロパティはJSON出力に含めない
    public string InternalId { get; set; }
}

Entity Framework Core (EF Core) によるO/Rマッピング

データベースのテーブル構造を定義する際、クラスとテーブルの対応を属性で制御します。

C#
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

[Table("M_Users")] // テーブル名を指定
public class UserEntity
{
    [Key] // 主キーを指定
    public int UserId { get; set; }

    [Column("display_name")] // カラム名を指定
    public string Name { get; set; }
}

このように、「コード上の名前」と「外部（JSON/DB）の名前」のギャップを埋める役割として属性は多用されます。

カスタム属性の作成と実装方法

標準の属性だけでは要件を満たせない場合、独自の属性を作成することができます。

独自の属性を作成することで、特定のビジネスロジックに基づいたメタデータを付与し、共通処理を自動化できるようになります。

1. 属性クラスの定義

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

また、[AttributeUsage] 属性を使用して、その属性が「どこに（クラス、メソッド等）」「何回」付与できるかを制限するのが一般的です。

C#
[AttributeUsage(AttributeTargets.Property, AllowMultiple = false)]
public class DisplayNameAttribute : Attribute
{
    public string Name { get; }
    public DisplayNameAttribute(string name)
    {
        Name = name;
    }
}

2. 属性の利用

作成した属性を、任意のプロパティに適用します。

C#
public class Employee
{
    [DisplayName("社員番号")]
    public int Id { get; set; }

    [DisplayName("フルネーム")]
    public string FullName { get; set; }
}

3. リフレクションによる属性の読み取り

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

実行時にリフレクションを使用して、付与された情報を読み取り、処理に活用します。

C#
using System.Reflection;

public static class AttributeReader
{
    public static void PrintDisplayNames(object obj)
    {
        var type = obj.GetType();
        var properties = type.GetProperties();

        foreach (var prop in properties)
        {
            // プロパティに付与されているDisplayNameAttributeを取得
            var attr = prop.GetCustomAttribute<DisplayNameAttribute>();
            if (attr != null)
            {
                Console.WriteLine($"{prop.Name} の表示名は: {attr.Name}");
            }
        }
    }
}
実行結果
Id の表示名は: 社員番号
FullName の表示名は: フルネーム

このように、カスタム属性とリフレクションを組み合わせることで、「データの定義」と「データの処理」を分離し、汎用性の高いライブラリやユーティリティを作成することが可能になります。

属性を使用する際の注意点とベストプラクティス

属性は非常に強力ですが、濫用するとかえってコードを複雑にする可能性があります。

以下のポイントを意識して設計しましょう。

パフォーマンスへの影響

リフレクションを用いた属性の読み取りは、通常のメソッド呼び出しに比べて計算コストが高くなります。

頻繁に呼び出されるループ処理の中でリフレクションを多用すると、アプリケーション全体のパフォーマンス低下を招く恐れがあります。

対策:

  • 読み取った属性情報はキャッシュする。
  • .NET 5以降であれば、Source Generators を検討する（コンパイル時にコードを生成するため、実行時のリフレクションが不要になる）。

属性には「ロジック」を書かない

属性はあくまで「メタデータの付与」が目的です。

属性クラスの中に複雑な計算ロジックや外部との通信処理を書くことは避けてください。

属性はシンプルにデータを保持するだけの構造体に近い設計にし、そのデータをどう扱うかは、それを読み取る側のクラスに任せるべきです。

依存関係に注意する

属性を独自のライブラリ（プロジェクト）で定義する場合、その属性を使用する全てのプロジェクトがそのライブラリを参照することになります。

ドメインモデルなどに独自の属性を付与しすぎると、モデルが特定の技術基盤に強く依存してしまうことがあるため、注意が必要です。

まとめ

C#の属性は、コードに対して「付加情報（メタデータ）」を与えるための非常に強力な機能です。

本記事で解説した主なポイントを振り返ります。

  • 標準属性の活用：[Obsolete] や [Conditional] を使い、コードの安全性やデバッグ効率を高める。
  • フレームワークとの連携：ASP.NET Coreのバリデーションやルーティング、JSONシリアライズ、EF Coreなどの主要な場面で、宣言的な記述を行う。
  • カスタム属性の作成：共通処理を自動化したい場合や、独自のメタデータ管理が必要な場合に Attribute クラスを継承して作成する。
  • パフォーマンス意識：実行時のリフレクション負荷を考慮し、適切にキャッシュやモダンな技術（Source Generators）を選択する。

属性を使いこなせるようになると、コードから冗長なif文や設定ファイルが消え、「何をするためのコードなのか」が明確な美しいプログラムを書くことができるようになります。

まずは標準で用意されている属性から積極的に取り入れ、慣れてきたら独自の属性を用いたスマートな設計に挑戦してみてください。