部分クラスと部分メソッド (C# プログラミングガイド)

[アーティクル]
06/10/2015

クラスや構造体、インターフェイスやメソッドの定義を、複数のソースファイルに分割できます。各ソースファイルには、型やメソッドの定義のセクションが含まれ、分割されたすべての部分はアプリケーションのコンパイル時に結合されます。

部分クラス

クラス定義を分割するのが望ましいのは、次のような場合です。

大型プロジェクトを開発する際に、クラスを別個のファイルに分割すると、複数のプログラマが同時にそのクラスの作業を行うことができます。
自動生成ソースを使用する際に、ソースファイルを再作成せずにコードをクラスに追加できます。 Visual Studio では、Windows フォームや Web サービスラッパーコードなどを作成するときにこのアプローチを使用します。 Visual Studio によって作成されたファイルを変更せずに、これらのクラスを使用するコードを作成できます。
クラス定義を分割するには、次のように partial キーワード修飾子を使用します。

public partial class Employee
{
    public void DoWork()
    {
    }
}

public partial class Employee
{
    public void GoToLunch()
    {
    }
}

partial キーワードは、クラス、構造体、またはインターフェイスの他の部分を名前空間内で定義できることを示します。 partial キーワードは、すべての部分で使用する必要があります。最終的な型を形成するためには、コンパイル時にすべての部分が用意できている必要があります。また、すべての部分で同じアクセシビリティ (public や private など) を使用する必要があります。

抽象と宣言された部分がある場合、型全体が抽象と見なされます。シールと宣言された部分がある場合、型全体がシールと見なされます。また、基本型を宣言する部分がある場合は、型全体が該当するクラスを継承します。

基本クラスを指定する部分はすべて一致する必要がありますが、基本クラスを省略する部分も基本型を継承します。部分は別の基本インターフェイスを指定でき、すべての部分宣言で示されたすべてのインターフェイスが最終的な型によって実装されます。部分定義で宣言されたクラス、構造体、インターフェイスの各メンバーは、他のすべての部分で利用できます。最終的な型は、コンパイル時にすべての部分を結合して形成されます。

注意

partial 識別子は、デリゲートや列挙宣言では使用できません。

次の例は、入れ子にされた型は、それを包含する型自体が partial でない場合でも、partial にできることを示しています。

class Container
{
    partial class Nested
    {
        void Test() { }
    }
    partial class Nested
    {
        void Test2() { }
    }
}

部分型定義の属性は、コンパイル時に結合されます。たとえば、次の宣言について考えてみます。

[SerializableAttribute]
partial class Moon { }

[ObsoleteAttribute]
partial class Moon { }

これらは、次の宣言と等価です。

[SerializableAttribute]
[ObsoleteAttribute]
class Moon { }

各部分型定義に含まれる次の要素は、すべて結合されます。

XML コメント
インターフェイス
ジェネリック型パラメーター属性
クラス属性
メンバー

たとえば、次の宣言について考えてみます。

partial class Earth : Planet, IRotate { }
partial class Earth : IRevolve { }

これらは、次の宣言と等価です。

class Earth : Planet, IRotate, IRevolve { }

制約

部分クラス定義の使用時には、以下の規則が適用されます。

同じ型の部分である部分型定義はすべて partial で修飾する必要があります。たとえば、次のクラス宣言はエラーになります。
```
public partial class A { }
//public class A { }  // Error, must also be marked partial
```
partial 修飾子は、class、struct、または interface キーワードの直前にのみ配置できます。

入れ子にされた部分型は、次の例で示すように、部分型定義で宣言できます。

partial class ClassWithNestedClass
{
    partial class NestedClass { }
}

partial class ClassWithNestedClass
{
    partial class NestedClass { }
}

同じ型の部分である部分型定義はすべて同じアセンブリまたは同じモジュール (.exe ファイルまたは .dll ファイル) 内で定義する必要があります。部分定義は、複数のモジュールにまたがることができません。
クラス名とジェネリック型パラメーターはすべての部分型定義で一致する必要があります。ジェネリック型は partial にできます。部分宣言では、それぞれ同じパラメーター名を同じ順序で使用する必要があります。
以下のキーワードは、部分型定義では省略できますが、ある 1 つの部分型定義に存在する場合は、同じ型の別の部分定義で指定されているキーワードと競合できません。
- public
- private
- protected
- internal
- abstract
- sealed
- 基本クラス
- new 修飾子 (入れ子にされた部分)
- ジェネリック制約
  
  詳細については、「型パラメーターの制約 (C# プログラミングガイド)」を参照してください。

例 1

Description

次の例では、クラス CoOrds のフィールドとコンストラクターを 1 つの部分クラス定義で宣言し、メンバー PrintCoOrds を別の部分クラス定義で宣言しています。

コード

public partial class CoOrds
{
    private int x;
    private int y;

    public CoOrds(int x, int y)
    {
        this.x = x;
        this.y = y;
    }
}

public partial class CoOrds
{
    public void PrintCoOrds()
    {
        Console.WriteLine("CoOrds: {0},{1}", x, y);
    }

}

class TestCoOrds
{
    static void Main()
    {
        CoOrds myCoOrds = new CoOrds(10, 15);
        myCoOrds.PrintCoOrds();

        // Keep the console window open in debug mode.
        Console.WriteLine("Press any key to exit.");
        Console.ReadKey();
    }
}
// Output: CoOrds: 10,15

例 2

Description

次の例は、部分構造体と部分インターフェイスも開発できることを示しています。

コード

partial interface ITest
{
    void Interface_Test();
}

partial interface ITest
{
    void Interface_Test2();
}

partial struct S1
{
    void Struct_Test() { }
}

partial struct S1
{
    void Struct_Test2() { }
}

部分メソッド

部分クラスまたは構造体に部分メソッドを含めることができます。クラスのある部分にメソッドのシグネチャが含まれます。同じ部分または別の部分に、オプションの実装を定義できます。実装を備えていない場合、メソッドとメソッドに対するすべての呼び出しは、コンパイル時に削除されます。

部分メソッドを使用すると、クラスのある部分の実装者はイベントに似た方法でメソッドの定義を行うことができます。クラスの別の部分の実装者は、メソッドを実装するかどうかを決定できます。メソッドを実装しないと、コンパイラはメソッドシグネチャとメソッドに対するすべての呼び出しを削除します。メソッドへの呼び出しは、呼び出しでの引数の評価により発生するすべての結果を含め、ランタイムには影響を与えません。したがって、部分クラス内のコードは、実装を備えていない部分メソッドでも自由に使用できます。呼び出されるメソッドが実装されていなくても、コンパイル時のエラーやランタイムエラーにはなりません。

部分メソッドは、生成されるコードをカスタマイズする方法として特に便利です。メソッドの名前とシグネチャを予約できるので、生成されるコードはメソッドを呼び出すことができ、メソッドを実装するかどうかは開発者が決定できます。部分クラスと同じように部分メソッドでも、コードジェネレーターが作成したコードと開発者である人間が作成したコードがランタイムコストなしで連携できます。

部分メソッドの宣言は、定義と実装の 2 つの部分から成ります。これらは部分クラスの別々の部分にあっても同じ部分にあってもかまいません。実装宣言がない場合は、定義宣言とメソッドに対するすべての呼び出しの両方が、コンパイラでの最適化によって除外されます。

// Definition in file1.cs
partial void onNameChanged();

// Implementation in file2.cs
partial void onNameChanged()
{
  // method body
}

部分メソッドの宣言はコンテキストキーワード partial で始まる必要があり、メソッドは void を返す必要があります。
部分メソッドには ref パラメーターを使用できますが、out パラメーターは使用できません。
部分メソッドは暗黙的に private です。したがって部分メソッドを virtual にすることはできません。
部分メソッドを extern にすることはできません。部分メソッドの定義なのか実装なのかは、本体の存在で決まるためです。
部分メソッドには static 修飾子と unsafe 修飾子を使用できます。
部分メソッドをジェネリックにできます。制約は部分メソッドの定義宣言に置き、必要に応じて実装宣言で繰り返すことができます。パラメーター名と型パラメーター名は、定義宣言と実装宣言で同じである必要はありません。
デリゲートは、定義および実装されている部分メソッドには使用できますが、定義されているのみの部分メソッドには使用できません。

C# 言語仕様

詳細については、「C# 言語仕様」を参照してください。言語仕様は、C# の構文と使用法に関する信頼性のある情報源です。

参照

概念

C# プログラミングガイド

部分クラスと部分メソッド (C# プログラミングガイド)