C# 部分クラスと部分メソッドを理解する

C# 部分クラスと部分メソッドを理解する

この記事では、C# 開発者が大規模コードベースの管理、効果的な協業、コンパイル最適化のために部分クラスと部分メソッドをどう活用するかを説明します。

複数の開発者が単一の大規模クラスで作業する場合や、Visual Studio などのツールで生成されるコードと手書きコードをマージする必要がある場合、C# の partial キーワードがクリーンな解決策を提供します。

---

部分クラスとは？

部分クラスを使用すると、単一のクラス定義を 2 つ以上のソースファイルに分割できます。各ファイルにはクラスの断片が含まれ、コンパイラがビルド時にそれらを結合します。クラスのすべての部分に partial キーワードが必要です。

例 1 – シンプルなクラスの分割

HeightWeightInfo というプロジェクトで、人の身長と体重を格納することを考えます。

namespace HeightWeightInfo {
    public partial class Record {
        private int h;
        private int w;
        public Record(int h, int w) {
            this.h = h;
            this.w = w;
        }
    }
}

同じ Record クラスが 2 番目のファイルで続きます。

namespace HeightWeightInfo {
    public partial class Record {
        public void PrintRecord() {
            Console.WriteLine("Height:" + h);
            Console.WriteLine("Weight:" + w);
        }
    }
}

最後に、クラスを使用するプログラム：

namespace HeightWeightInfo {
    class Program {
        static void Main(string[] args) {
            Record myRecord = new Record(10, 15);
            myRecord.PrintRecord();
            Console.ReadLine();
        }
    }
}

コンパイラは 2 つの Record 定義を、コンストラクターと PrintRecord メソッドの両方を含む単一のクラスにマージします。

部分クラスを使用する場面

1. 複数開発者の大規模プロジェクト：各メンバーが別ファイルを編集でき、競合を回避。
2. 自動生成コード：IDE が生成する手動編集すべきでないファイルに対して、部分クラスでカスタムロジックを追加可能。

覚えておくべき重要ポイント

• partial キーワードはクラスに寄与するすべてのファイルに必要。
• すべての部分は同じ名前空間にあり、一緒にコンパイルされる必要がある。
• すべての部分で同じアクセス修飾子（public、internal 等）を共有。
• いずれかの部分で abstract または sealed 宣言があると、クラス全体がその属性を継承。
• いずれかの部分で定義されたメンバーは他のすべての部分から可視。
• デリゲートや列挙型には partial 修飾子を使用不可。

---

部分メソッドとは？

部分メソッドは、部分クラスの 1 部で宣言され、別の部分でオプションで実装される特殊なメソッドです。実装が省略された場合、メソッド宣言とその呼び出しの両方がコンパイル時に除去されるため、パフォーマンス向上が可能です。

例 2 – 部分メソッドの使用

file1.cs で Car クラスが部分メソッドと他の通常メソッドを宣言：

public partial class Car {
    partial void InitializeCar();
    public void BuildRim() { }
    public void BuildWheels() { }
}

file2.cs で同じ Car クラスが InitializeCar の実装と別のメソッドを提供：

public partial class Car {
    public void BuildEngine() { }
    partial void InitializeCar() {
        string str = "Car";
    }
}

部分メソッド宣言は 2 部で構成されます：1 つのファイルでのシグネチャと、同じまたは別のファイルでのオプションの実装。

部分メソッドのルール

• partial キーワードで宣言必須。
• 戻り値の型は常に void（戻り値なし）。
• 暗黙的に private；public、protected、internal 不可。
• virtual、override、abstract 宣言不可。
• 実装が提供されない場合、コンパイラがメソッドとその呼び出しを除去。