CS2001～

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

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

C#のコンパイルエラーCS2017は、ライブラリやモジュールのビルド時に/mainオプションを指定すると発生します。

このオプションは通常、実行可能ファイルのエントリポイントを定義するために使用されるため、ライブラリ作成時には不要です。

開発環境が整っており、基本操作が理解できている場合は、/main指定を削除することでエラーを解消できます。

目次から探す

エラー発生の原因
- ライブラリ作成時のエントリポイント指定
- ビルドターゲットの設定不一致
エラー解消の対策
- /mainオプションの削除方法
- 正しいビルドオプションの指定
まとめ

エラー発生の原因

ライブラリ作成時のエントリポイント指定

/mainオプションの役割

C#コンパイラでは、アプリケーションのエントリポイントを指定するために「/main」オプションが存在します。

このオプションを使うと、複数の候補がある場合に特定のクラスをエントリポイントとして明示的に指定することができます。

しかし、ライブラリとしてコンパイルする場合はエントリポイントが不要であり、/mainの指定が不要となります。

そのため、ライブラリ作成時に/mainオプションを指定すると、コンパイラはライブラリの仕様に合わないと判断し、CS2017エラーを発生させます。

不要なエントリポイント指定による問題

ライブラリとしてのビルドでは、エントリポイントを持たないコードが求められます。

もし無用な/mainオプションが指定されると、コンパイラは「モジュールまたはライブラリをビルドする場合は/mainを指定できません」というエラーを出します。

以下のサンプルコードは、/mainオプションを使用してライブラリをビルドしようとした場合の例です。

// CS2017.cs
// 以下のコマンドでコンパイルするとエラーが発生します。
// csc /main:MyClass /target:library CS2017.cs
using System;
class MyClass
{
    // ライブラリ作成時にエントリポイントは不要です。
    public static void Main()
    {
        Console.WriteLine("これはエントリポイントとして指定されたコードです。");
    }
    // ライブラリの機能を提供するメソッド
    public void LibraryMethod()
    {
        Console.WriteLine("ライブラリメソッドの処理です。");
    }
}

コンパイラ エラー CS2017: モジュールまたはライブラリをビルドする場合は /main を指定できません。

ビルドターゲットの設定不一致

/targetオプションにおける誤設定

C#ではビルドターゲットを指定するために「/target」オプションを利用します。

通常、アプリケーションであれば/target:exe、ライブラリであれば/target:libraryと指定します。

設定が不一致の場合、たとえばライブラリとしてビルドするはずのプロジェクトに対して誤ってエントリポイントの指定や実行可能な形式用のオプションが混在すると、コンパイラは矛盾を検知しエラーを発生させます。

このような誤設定はプロジェクトの構成ファイルやコンパイル時の引数に起因することが多いです。

エラー解消の対策

/mainオプションの削除方法

コマンドライン引数の見直し

コマンドラインでコンパイルを行っている場合、エントリポイント指定用の/mainオプションが不要なライブラリ向けのビルドでは削除する必要があります。

たとえば、以下のコマンドはエラーが発生する原因となります。

csc /main:MyClass /target:library MyLibrary.cs

正しいコマンドは、/mainオプションを削除し、ターゲットをライブラリに指定するように変更します。

csc /target:library MyLibrary.cs

このようにコマンドライン引数を調整することで、CS2017エラーを回避することができます。

プロジェクトファイルの修正

Visual Studioなどの統合開発環境を利用している場合、プロジェクトファイル.csproj内に不要なエントリポイント指定が含まれている可能性があります。

プロジェクトファイルを開き、Mainに関する設定や誤ったプロパティが設定されていないか確認してください。

ライブラリとしてビルドする際は、特に以下の点に注意してください。

・<OutputType>Library</OutputType>の設定が行われていること

・エントリポイント指定に関する設定が存在しないこと

以下は、プロジェクトファイルが正しく設定されている例です。

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Library</OutputType>
    <TargetFramework>net6.0</TargetFramework>
  </PropertyGroup>
</Project>

正しいビルドオプションの指定

/target:library の適用

ライブラリとしてプロジェクトをビルドする場合、/target:libraryオプションを正しく指定することが重要です。

この指定により、コンパイラはライブラリとしての出力を意識し、エントリポイントの検証を行わなくなります。

たとえば、以下のコマンドでのコンパイルは正しい指定例です。

csc /target:library MyLibrary.cs

プロジェクトファイルを利用している場合も同様に、<OutputType>Library</OutputType>の設定がされていることを確認してください。

他の設定項目の確認

コンパイルオプションとしては、/mainおよび/target以外にも影響を与える設定項目が存在する場合があります。

プロジェクトファイル全体やコマンドライン引数を再確認して、ライブラリ向けの設定に矛盾がないか検証してください。

特に、以下の点に注意すると良いです。

・使用しているSDKやフレームワークのバージョンが適切か

・その他のコンパイラオプションがライブラリと互換性があるか

正しい設定に修正した上で、再コンパイルを実行してください。

動作確認用のサンプルコードとして、以下の例を参照ください。

using System;
class LibraryComponent
{
    // ライブラリが提供する機能のサンプルメソッド
    public void ExecuteFunction()
    {
        Console.WriteLine("ライブラリ処理が正常に実行されました。");
    }
}
class Program
{
    // Main関数は、ライブラリとしての動作確認用に用意したサンプルエントリポイントです。
    // ライブラリとして配布する場合は通常不要です。
    static void Main(string[] args)
    {
        LibraryComponent component = new LibraryComponent();
        component.ExecuteFunction();
    }
}

ライブラリ処理が正常に実行されました。

まとめ

本記事では、C#コンパイラエラー CS2017 の原因と解決方法について学ぶことができます。

ライブラリ作成時に不要な「/main」オプション指定がエラーを引き起こす理由や、ビルドターゲットの設定不一致に伴う問題点を説明し、正しいコマンドライン引数およびプロジェクトファイルの修正方法について具体例を通して解説しました。

これにより、適切な設定でエラーの発生を防げるようになります。