CS801～2000

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

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

CS1565は、C#のコンパイラエラーで、1つのコンパイルでWin32ResourceオプションとWin32Iconオプションを同時に指定すると発生します。

指定されたオプションに矛盾があるため、正しくビルドが行われず、設定の見直しが求められます。

目次から探す

CS1565の原因
CS1565の対策
- コンパイル設定の見直し
- Visual Studio上での設定調整
開発環境での注意事項
- 設定変更が他機能に与える影響の検証
まとめ

CS1565の原因

本セクションでは、コンパイラエラー CS1565の原因となる各オプションの役割と、両者を同時に指定した際の競合について説明します。

Win32Resourceオプションの役割

Win32Resourceオプションは、コンパイル時にWin32リソースファイルを埋め込むための指定です。

このリソースファイルには、アイコン、バージョン情報、文字列情報などのリソースが含まれることが一般的です。

プロジェクト内に別途用意したリソースファイル(例: sample.res)を指定することで、実行ファイル内にリソースを統合できるようになります。

以下は、Win32Resourceオプションを使用する場合のサンプルコードの例です。

using System;
namespace Win32ResourceSample
{
    class Program
    {
        static void Main(string[] args)
        {
            // リソースファイルの名称を指定
            string resourceFile = "sample.res"; // ここで指定するリソースファイルは、プロジェクトに存在する必要があります
            Console.WriteLine("使用中のWin32リソースファイル: " + resourceFile);
        }
    }
}

使用中のWin32リソースファイル: sample.res

Win32Iconオプションの役割

Win32Iconオプションは、コンパイル時に実行ファイルにアイコンを埋め込むための指定です。

このオプションを使用することで、作成される実行ファイルに専用のアイコンを付加することが可能です。

通常、.icoファイルを指定しますが、リソースファイルと連携させるのではなく、直接アイコンファイルを設定する用途となります。

以下は、Win32Iconオプションを使用する場合のサンプルコードの例です。

using System;
namespace Win32IconSample
{
    class Program
    {
        static void Main(string[] args)
        {
            // アイコンファイルの名称を指定
            string iconFile = "app.ico"; // 指定するアイコンファイルは、プロジェクト内に配置してください
            Console.WriteLine("使用中のWin32アイコンファイル: " + iconFile);
        }
    }
}

使用中のWin32アイコンファイル: app.ico

両者の同時指定による競合

Win32ResourceオプションとWin32Iconオプションは、いずれも実行ファイルにリソースを埋め込むための指定ですが、同一のコンパイルで両方を指定すると競合が発生します。

競合が起こる理由は、Win32Resourceオプションにより既に埋め込まれたリソース内でアイコンが設定されることがあり、Win32Iconオプションで別途指定されたアイコンと重複し、明確な優先順位が決まらないためです。

その結果、コンパイラはエラー CS1565 を発生させ、どちらのオプションにも対応できない状態となります。

エラーを解消するためは、どちらか一方のオプションの使用を選択し、設定を統一する必要があります。

CS1565の対策

このセクションでは、CS1565エラーを回避するための対策方法について解説します。

プロジェクトファイルやコマンドラインオプションの設定見直し、ならびにVisual Studio上での調整方法をご紹介します。

コンパイル設定の見直し

コンパイル設定の見直しを行うことで、エラーを発生させないように環境を整えることが可能です。

基本的にはWin32ResourceとWin32Iconのどちらか一方の指定に統一することが推奨されます。

プロジェクトファイルの設定変更

Visual Studioのプロジェクトファイル.csprojを編集して、不要なオプションが設定されていないか確認します。

例えば、.csprojファイル内に以下のような記述があれば、どちらか一方の指定を削除してください。

<PropertyGroup>
  <!-- この例ではWin32Iconの指定が含まれています -->
  <ApplicationIcon>app.ico</ApplicationIcon>
  <!-- Win32Resourceの指定がある場合はコメントアウトまたは削除する -->
  <!-- <Win32Resource>sample.res</Win32Resource> -->
</PropertyGroup>

Win32Iconを使用するか、Win32Resourceに統一するかの判断は、プロジェクトの要求されるリソース管理に従って行ってください。

コマンドラインオプションの確認

コマンドラインからコンパイルする際にも、両オプションが同時に指定されていないか確認が必要です。

例えば、以下のようにコンパイルしている場合は、両方が含まれていないかをチェックします。

csc /win32resource:sample.res /win32icon:app.ico Program.cs

上記の例では、両方のオプションが同時に指定されているため、エラー CS1565 が発生します。

どちらか一方のオプションを削除して、適切なリソース管理を行うようにしてください。

Visual Studio上での設定調整

Visual Studioのプロジェクトプロパティから、リソースの設定を行うことも可能です。

以下の手順で設定を確認してください。

プロジェクトのプロパティ画面を開きます。
「アプリケーション」タブ内の「リソース」設定を確認します。
Application Iconに指定されているファイルと、必要に応じてWin32リソースファイルの指定が被っていないかチェックします。

この方法により、GUIで簡単に設定内容を確認および変更できるため、コマンドラインやプロジェクトファイルの直接編集に不慣れな場合にも安心して利用できる方法です。

開発環境での注意事項

開発環境における設定変更は、他の機能や依存関係に影響を及ぼす可能性があるため、変更前に十分な検証を行う必要があります。

設定変更が他機能に与える影響の検証

プロジェクトの設定を変更する際は、以下の点に注意してください。

リソース管理に関連する他のプロジェクト設定や参照が変更される可能性がある点。
他のプロジェクトメンバーと協力して、設定の統一性を保つことが重要です。
コード内でリソースの読み込みや利用方法が変更後の設定に適合しているかテストを行うこと。

以下は、設定変更後に正しく動作するかを確認するための簡単なサンプルコードです。

using System;
namespace EnvironmentCheckSample
{
    class Program
    {
        static void Main(string[] args)
        {
            // 現在のリソース設定情報を出力して、設定の影響を確認する例です。
            string activeResource = "設定一例"; // リソース設定に基づいた情報を設定してください
            Console.WriteLine("現在のリソース設定: " + activeResource);
        }
    }
}

現在のリソース設定: 設定一例

設定の変更が他の機能に及ぼす影響については、各機能が正しく動作するか複数回のビルドと動作確認を行い、エラーや不整合がないかを確認してください。

まとめ

この記事では、CS1565エラーの原因と対策について解説しています。

Win32Resourceオプションはリソースファイルの埋め込み、Win32Iconオプションはアイコンの設定を行い、両者を同時に指定すると競合が生じエラーとなります。

対策としては、プロジェクトファイルやコマンドライン、Visual Studio上での設定を見直し、一方のオプションで統一することが推奨されます。

また、設定変更が他の機能に与える影響についても十分な検証が必要です。