CS0～400

C# CS0262 エラーについて解説 – partial型宣言のアクセシビリティ修飾子競合の原因と対処法

2025-03-29更新日: 2025-03-29

CS0262 エラーは、partial型の複数の宣言間で、アクセス修飾子が一致していない場合に発生します。

各部分宣言で同じアクセス修飾子を指定する必要がございます。

矛盾があると、コンパイラがどの修飾子を採用すべきか判断できず、エラーと表示されます。

目次から探す

エラー原因の詳細
- partial型におけるアクセシビリティ修飾子の役割
- 複数宣言間での競合事例
partial型宣言の仕様とルール
- 宣言間で統一すべきアクセシビリティ修飾子
エラー検出と確認手順
- コンパイラメッセージの解析方法
- 開発環境での検証プロセス
対処方法と修正手順
まとめ

エラー原因の詳細

partial型におけるアクセシビリティ修飾子の役割

partial型では、1つの型を複数のソースファイルに分割して記述することが可能です。

各部分宣言においてアクセシビリティ修飾子(例：public、internalなど)が指定される場合、すべての宣言で統一する必要があります。

たとえば、1つのファイルでpublicと宣言し、別のファイルで修飾子無し(内部アクセス)として宣言すると、コンパイラはアクセシビリティの競合を検出し、エラー CS0262 を報告します。

アクセシビリティ修飾子は、型やメンバーの外部への公開範囲を定義しているため、partial宣言間で整合性が取れていない場合、型全体のアクセスレベルが不明瞭となり、予期しない動作やセキュリティ上の問題に発展する可能性があります。

複数宣言間での競合事例

複数のpartial宣言間でアクセシビリティ修飾子が異なる場合、コンパイラはエラーとして検出します。

たとえば、下記のコード例では、ExampleClass の1部では public として宣言され、もう1部では修飾子が省略されています。

これにより、エラー CS0262 が発生します。

// File: ExamplePart1.cs
public partial class ExampleClass
{
    // この部分ではpublicとして宣言されています
    public void MethodA()
    {
        // 処理内容(例：メッセージを出力)
        System.Console.WriteLine("MethodA実行");
    }
}
// File: ExamplePart2.cs
partial class ExampleClass // アクセシビリティ修飾子が指定されていません
{
    public void MethodB()
    {
        // 処理内容(例：メッセージを出力)
        System.Console.WriteLine("MethodB実行");
    }
}
class Program
{
    static void Main()
    {
        ExampleClass instance = new ExampleClass();
        instance.MethodA();
        instance.MethodB();
    }
}

MethodA実行
MethodB実行

上記のコードは、実際に実行するとエラーが発生するため、アクセシビリティ修飾子の整合性を保つ必要があります。

partial型宣言の仕様とルール

宣言間で統一すべきアクセシビリティ修飾子

すべてのpartial宣言では、型に対して同一のアクセシビリティ修飾子を用いる必要があります。

たとえば、public partial class として宣言した部分と、修飾子を省略した部分(内部アクセスとみなされる)を混合すると、コンパイラはエラーを報告します。

同一の型であることを明確にするため、すべての宣言で同じアクセスレベルを指定する必要があります。
アクセス修飾子が一致しない場合、型全体の一貫性が確保されず、意図しないアクセス制御になる可能性があります。

クラス、構造体、インターフェイスでの適用方法

クラス、構造体、インターフェイスなど、すべての型宣言においてアクセシビリティの指定は必須です。

下記のサンプルコードは、正しく統一された宣言例です。

// File: CorrectPartial1.cs
public partial class SampleType
{
    public void DisplayMessage()
    {
        System.Console.WriteLine("DisplayMessage from Partial1");
    }
}
// File: CorrectPartial2.cs
public partial class SampleType
{
    public void ShowMessage()
    {
        System.Console.WriteLine("ShowMessage from Partial2");
    }
}
class Program
{
    static void Main()
    {
        SampleType sample = new SampleType();
        sample.DisplayMessage();
        sample.ShowMessage();
    }
}

DisplayMessage from Partial1
ShowMessage from Partial2

各部分宣言において必ず public を指定することで、コンパイラエラーを回避し、一貫性が保たれます。

宣言形式と整合性の確認ポイント

partial宣言では、以下のポイントに注意する必要があります。

型の種類(class、struct、interfaceなど)がすべて一致しているか。
アクセシビリティ修飾子がすべて一致しているか。
型パラメーターや制約が一致しているか。

整合性の確認が必要な場合、各ファイルの宣言部分を再確認し、すべて同一の仕様に従った記述に修正することをおすすめします。

エラー検出と確認手順

コンパイラメッセージの解析方法

コンパイラは、アクセシビリティ修飾子の不一致が発生すると、具体的なエラーコード(例：CS0262)とその原因を示したメッセージを出力します。

エラーメッセージには、該当するファイルや行番号が記載されるため、問題箇所を特定する際の参考となります。

メッセージの例としては、以下のような記述がされます。

「型の部分宣言に競合するアクセシビリティ修飾子が含まれています」

このメッセージを手掛かりに、対象ファイル間の宣言内容を比較することが重要です。

コードの不整合があれば、すぐに修正する必要があります。

開発環境での検証プロセス

開発環境においては、ビルド時にコンパイラが提供するエラーメッセージと警告を注意深く確認することが求められます。

エラーメッセージは、IDE上のエラーリストやコンソールに表示されるため、これらを参照しながら正しい修正方法を検討します。

まず、エラーが発生した箇所のファイルを特定します。
次に、エラーメッセージ内の指摘内容に従い、アクセシビリティ修飾子や宣言内容の不一致を探します。
最後に、宣言内容の統一を図ります。

Visual Studioでのエラー検出手順

Visual Studioを利用している場合、以下の手順でエラー箇所を確認することができます。

ビルドボタンを押してプロジェクト全体をコンパイルします。
エラーリストウィンドウに表示されたエラーコード(例：CS0262)を確認します。
エラーコードをダブルクリックすると、該当する行にジャンプされ、どのファイルで不一致が発生しているかが明確に表示されます。
各部分宣言を並べて比較し、アクセス修飾子の統一が取れているか確認します。

これにより、具体的な原因と修正位置が容易に把握できるようになります。

対処方法と修正手順

競合箇所の特定手法

コンパイラが表示するエラーコードに基づいて、まずは競合している部分宣言の箇所を特定します。

エラーメッセージに記載されたファイルや行番号、またはVisual Studioのエラーリストを活用して、以下の手順で確認します。

エラーコード(CS0262など)をメモします。
該当する複数のpartial宣言を開き、アクセシビリティ修飾子を比較します。
一致していない部分を抽出し、どちらに修正するか判断します。

各部分宣言の見直しポイント

各ファイルの宣言内容を見直す際は、以下の点に注意してください。

すべて同じアクセシビリティ修飾子(例：public)を指定する。
型名、型パラメーター、制約が一致しているか確認する。
クラス、構造体、インターフェイスの種類がすべて同じであるか確認する。

サンプルコードを修正する前後の例を以下に示します。

修正前

// File: ConflictPart1.cs
public partial class ConflictDemo
{
    public void ShowPart1()
    {
        System.Console.WriteLine("ConflictDemo Part1");
    }
}
// File: ConflictPart2.cs
partial class ConflictDemo // 修飾子が異なっています
{
    public void ShowPart2()
    {
        System.Console.WriteLine("ConflictDemo Part2");
    }
}
class Program
{
    static void Main()
    {
        ConflictDemo demo = new ConflictDemo();
        demo.ShowPart1();
        demo.ShowPart2();
    }
}

修正後

// File: FixedPart1.cs
public partial class ConflictDemo
{
    public void ShowPart1()
    {
        System.Console.WriteLine("ConflictDemo Part1");
    }
}
// File: FixedPart2.cs
public partial class ConflictDemo // 統一してpublicに統一
{
    public void ShowPart2()
    {
        System.Console.WriteLine("ConflictDemo Part2");
    }
}
class Program
{
    static void Main()
    {
        ConflictDemo demo = new ConflictDemo();
        demo.ShowPart1();
        demo.ShowPart2();
    }
}

ConflictDemo Part1
ConflictDemo Part2

修正実施後の確認方法

修正後は、コンパイルと実行を再度行い、エラーが解消されたことを確認します。

以下の手順を参考にしてください。

すべてのpartial宣言を見直し、アクセシビリティ修飾子が統一されているか確認する。
プロジェクトを再コンパイルし、コンパイラエラーメッセージが解消されたか確認する。
実行して正しい出力結果が得られるか、動作検証を行う。

上記の手順を徹底することで、partial宣言におけるアクセシビリティ修飾子の競合エラーを確実に解決することができます。

まとめ

この記事では、partial型宣言におけるアクセシビリティ修飾子の役割と、その不統一による競合事例、エラー原因について解説しています。

各ファイルで同じアクセシビリティ修飾子を指定する必要性を明示し、コンパイラエラー(例：CS0262)の原因と検出方法、Visual Studioでの具体的な確認手順を紹介しました。

また、エラー修正のための手法と修正後の動作確認の方法も示し、効果的な対処法が学べる内容となっています。