C# コンパイラ エラー CS0017の原因と対処法について解説

CS0017エラーは、C#プログラムで複数のエントリポイントが定義されている場合に発生します。

一般的に、プログラムには1つのMainメソッドのみが必要なため、余分なMainメソッドが存在するとコンパイルエラーとなります。

対策として、不要なMainメソッドを削除するか、/mainオプションで使用するエントリポイントを指定してください。

エラーの基本概要

C#におけるエントリポイントの役割

C#のプログラムは、実行開始時に必ずエントリポイントとして定義されたMainメソッドから動作を開始します。

このMainメソッドはプログラムのスタートラインであり、実行環境は最初にこのメソッドを呼び出すため、存在は必須です。

実行ファイル(.exe)の場合、必ず1つのエントリポイントだけを保持する必要があり、複数存在するとどのメソッドを実行すべきか判断できなくなるため、エラーが発生します。

CS0017エラーの発生メカニズム

CS0017エラーは、1つのプログラム内に複数のMainメソッドが定義された場合に発生します。

実行時にどのクラスのMainメソッドを利用するかをコンパイラが自動的に判断できず、エントリポイントとして複数の候補が存在することで、エラーが出力されます。

また、/mainオプションを正しく設定しない場合も、どのMainメソッドを使用するかが明示されず、同様のエラーが起こる可能性があります。

エラーの原因

複数のMainメソッドが存在するケース

複数のMainメソッドが同一プロジェクト内に存在する場合、C#コンパイラはどのメソッドをエントリポイントとするか判断できません。

たとえば、別々のクラスにそれぞれMainメソッドが存在すると、実行時にどちらを呼び出すか決定できず、CS0017エラーが発生します。

/mainオプションの使用不備

C#コンパイラでは、/mainオプションを使用してエントリポイントとなるMainメソッドを明示的に指定することができます。

しかし、このオプションが適切に指定されていない場合や間違ったクラス名を指定した場合、希望するエントリポイントが認識されずにエラーが発生します。

特に複数のMainメソッドがある場合は、/mainオプションで正しいクラスを指定するか、不要なMainメソッドを削除する必要があります。

エラーの対処法

不要なMainメソッドの削除

最もシンプルな対処法は、プロジェクト内の不要なMainメソッドを削除する方法です。

エントリポイントとして利用する予定のクラス以外に定義されているMainメソッドを削除することで、エラーを解消できます。

複数の候補がある場合、どちらか一方のみを残すようにコードを整理してください。

StartupObjectオプションの設定方法

エントリポイントとして複数のMainメソッドを残したい場合は、StartupObjectまたは/mainオプションを利用して、どのMainメソッドをエントリポイントとするか明示的に指定する方法があります。

コマンドラインでの指定例

コマンドラインからコンパイルする場合、/mainオプションを利用してエントリポイントを指定できます。

例えば、クラス名がProgramAのMainメソッドをエントリポイントとする場合は、以下のように指定します。

csc /main:ProgramA Program.cs

プロジェクト設定での指定手順

Visual StudioなどのIDEを利用している場合は、プロジェクトプロパティからStartup object(スタートアップオブジェクト)を設定することで、エントリポイントを明示できます。

1. プロジェクトを右クリックして「プロパティ」を選択します。
2. 「アプリケーション」タブを開き、Startup objectのドロップダウンから希望するクラス(例: ProgramA)を選択します。

この設定により、ビルド時に正しいエントリポイントが選択され、CS0017エラーが回避されます。

コード例による検証

エラー発生時のコード例

以下は、複数のMainメソッドが存在するためにCS0017エラーが発生する例です。

using System;
public class ProgramA
{
    // エントリポイントとして想定されるMainメソッド
    public static void Main()
    {
        Console.WriteLine("ProgramA 実行");
    }
}
public class ProgramB
{
    // このMainメソッドも存在するため、エラーが発生する
    public static void Main()
    {
        Console.WriteLine("ProgramB 実行");
    }
}
// メイン関数は必ず1つだけ定義する必要があります

エラー CS0017: プログラム 'YourAssembly.exe' に複数のエントリーポイントが定義されています。 エントリーポイントを含む型を指定するために /main を使用してください。

修正後のコード例

不要なMainメソッドを削除するか、正しいエントリポイントを明示することでエラーが解消されます。

以下は、ProgramAのみをエントリポイントとして残した修正例です。

using System;
public class ProgramA
{
    // このMainメソッドがエントリポイントとして実行されます
    public static void Main()
    {
        Console.WriteLine("ProgramA 実行");
    }
}
// ProgramB のMainメソッドは削除するか、エントリポイントから除外します
// public class ProgramB
// {
//     public static void Main()
//     {
//         Console.WriteLine("ProgramB 実行");
//     }
// }

ProgramA 実行

まとめ

この記事では、C#のエントリポイントであるMainメソッドの役割や、複数設定された場合に発生するCS0017エラーの原因について解説しています。

不要なMainメソッドの削除と、/mainやStartupObjectオプションを使用して正しいエントリポイントを指定する手法を具体例とともに説明しています。

これにより、エラー発生時の原因把握と適切な対処方法が理解できる内容となっています。