C# コンパイラ エラー CS1563について解説：OutputAssemblyオプションの設定と注意点

C#のコンパイラエラー CS1563は、OutputAssemblyオプションを使用した後に、ソースコードファイルが指定されていない場合に発生します。

指定した出力ファイルに対して対応するソースが存在しないため、コンパイラがエラーを出力します。

解消するには、OutputAssemblyオプションを見直すか、必要なソースファイルを追加してください。

エラー発生条件

ソースファイル未指定時の動作

C# コンパイラで OutputAssembly オプションを使用する場合、ソースファイルが指定されないとコンパイラ エラー CS1563 が発生します。

これは、出力ファイル名は指定されたものの、実際にコンパイルするソースコードが存在しないためです。

たとえば、以下のようにソースファイルの指定が抜けているとエラーになります。

• コマンド例:

csc /out:MyApplication.exe

この状態では、コンパイラは出力ファイル MyApplication.exe を生成する情報はあるものの、どのソースコードをコンパイルすればよいか判断できないため、エラーが発生します。

OutputAssemblyオプション使用時の注意

OutputAssembly オプションを使用する際には、必ずコンパイル対象となるソースファイルを正しく指定する必要があります。

コマンドラインで使用する場合、オプションとソースファイルの順序に注意してください。

たとえば、/out:MyApplication.exe の後にソースファイルが続いていなければ、同様のエラーが発生します。

また、Visual Studio などの統合開発環境でプロジェクト設定を変更する場合も、出力ファイル名とコンパイル対象のソースコードが整合することを確認することが大切です。

OutputAssemblyオプションの役割と設定

オプションの基本機能

OutputAssembly オプションは、コンパイラに対して出力されるアセンブリ(実行可能ファイルやライブラリ)のファイル名を指定するために使用されます。

このオプションは、標準の出力名を変更したい場合や、自動生成される出力ファイル名と異なる名前を付けたい場合に利用されます。

たとえば、以下のように使用します。

• オプションの使用例:

csc /out:MyCustomApp.exe MyProgram.cs

この場合、MyProgram.cs のソースコードをコンパイルし、出力ファイルとして MyCustomApp.exe を生成します。

設定順序と記述方法

ソースファイル指定のタイミング

OutputAssembly オプションを利用する場合、ソースファイルの指定タイミングに注意が必要です。

• /out オプションの後に少なくとも1つ以上のソースファイルが指定されていなければ、コンパイラはコンパイル対象のコードがないと判断し、エラー CS1563 を出力します。
• コマンドラインにおいては、オプションの順序が結果に影響するため、オプションと共にコンパイルするソースファイルが明確に指定されていることを確認してください。

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

以下に、OutputAssembly オプションを正しく指定したサンプルコードを示します。

サンプルコードには Main関数が含まれており、実際にコンパイル可能な内容となっています。

using System;
// サンプルプログラム: コンソールに挨拶メッセージを表示します。
public class Program
{
    public static void Main()
    {
        // 挨拶メッセージを出力
        Console.WriteLine("こんにちは、世界！");
    }
}

このプログラムを Program.cs として保存し、以下のコマンドでコンパイルしてください。

csc /out:MyCustomApp.exe Program.cs

実行すると、以下のような出力が得られます。

こんにちは、世界！

コンパイル環境別の確認ポイント

コマンドライン環境での設定確認

コマンドライン環境でコンパイルする際は、以下の点を確認してください。

• /out オプションが正しいファイル名で指定されているか
• オプションの後にソースファイルが必ず指定されているか
• パス指定に誤りがないか

これらの確認により、エラー CS1563 の発生を防ぐことができます。

Visual Studioでの設定確認

プロジェクトファイルの見直し

Visual Studio でプロジェクトを構築している場合、プロジェクトファイル.csprojの設定も確認することが重要です。

• <AssemblyName> タグで出力ファイルの名前が正しく設定されているか
• <OutputType> タグで実行可能ファイルやライブラリとして適切に指定されているか

プロジェクトファイルを見直すことで、手動でのコマンドライン指定と同様のエラーを防ぐことができます。

プロパティ設定の確認

Visual Studio のプロパティ設定画面でも、出力アセンブリに関する設定が確認できます。

• 「プロジェクトのプロパティ」→「ビルド」タブで、出力ファイル名や出力パスが正しく設定されているかをチェックしてください。
• 「アプリケーション」タブで、アセンブリ名やルート名前空間が正しく入力されているかを確認することが推奨されます。

以上の点を確認することで、Visual Studio の環境下でも OutputAssembly オプションに起因するエラー CS1563 を回避できるようになります。

まとめ

この記事を読むと、C#コンパイラエラー CS1563 の発生原因や回避方法が理解できます。

具体的には、OutputAssembly オプションを使用する場合のソースファイル指定のタイミングの重要性、コマンドラインおよびVisual Studioでの設定確認手順が明確にされています。

正しい設定手順を把握することで、エラー発生を未然に防ぐ方法がわかります。