C# コンパイラエラー CS1906 の原因と対策を解説

C#で発生するコンパイラ エラー CS1906は、/resourceや/linkresourceオプションで無効なアクセシビリティ修飾子が指定された場合に表示されます。

指定可能な修飾子はpublicまたはprivateに限定されるため、構文を見直して正しい指定に修正する必要があります。

Microsoft Learnの公式記述を参考に、オプションの設定を確認することをおすすめします。

エラー発生の背景と原因

/resource と /linkresource の仕組み

基本仕様と記述方法

C# のコンパイラでは、外部リソースをアセンブリに組み込むために /resource および /linkresource オプションが用意されています。

これらのオプションは、指定されたリソースファイルをプロジェクトに埋め込むか、参照リンクとして扱うためのものです。

記述方法は、例えば以下のように指定します。

/resource:MyResource.txt,public
/linkresource:ExternalResource.txt,private

コマンドオプションの利用意図

これらのオプションは、リソースファイルのアクセス範囲を指定しながら、ビルドプロセス中に正しく組み込むために利用されます。

表形式で説明すると以下のようになります。

設定により、リソースがどのように外部から参照できるかを明確に指定できるため、アプリケーションのセキュリティや動作に影響します。

アクセシビリティ修飾子の規定

許容される修飾子: public と private

リソースのアクセス可能範囲は、必ず public または private でなければなりません。

例えば、リソースファイル全体を外部に公開する場合は public、その逆の場合は private を指定します。

これは、コンパイラが内部的にリソースのアクセスレベルを管理するためのルールです。

修飾子指定時の注意点

指定可能な値は限られており、たとえば internal や protected といった修飾子は使用できません。

また、大小文字が区別されるため、正確に public または private と入力する必要があります。

誤った修飾子を指定すると、コンパイラはエラー CS1906 を報告します。

誤ったオプション指定の事例

エラー CS1906 発生の具体例

誤ったオプションが記述された場合、コンパイラは以下のようなエラーメッセージを出力します。

・「無効なオプション ‘option’ です。

リソースの参照可能範囲は ‘public’ または ‘private’ でなければなりません」

このエラーは、たとえばリソースのアクセシビリティに internal を指定してしまった場合に発生します。

記述ミスの実例

以下の例は誤った記述例です。

/resource:SampleResource.txt,internal  // internal は無効な修飾子です

この記述により、コンパイラはエラー CS1906 を出力し、ビルドが中断されます。

正しくは以下のように public または private を指定する必要があります。

エラー発生時の対応方法

正しいオプション指定の確認

/resource および /linkresource の正しい構文

正しい構文を使用することで、リソースの組み込みやリンクが適切に行われます。

例えば、正しい指定例は以下の通りです。

/resource:SampleResource.txt,public
/linkresource:LinkedResource.txt,private

構文は、「ファイル名,アクセシビリティ」の形式を守る必要があります。

また、パスに空白が含まれる場合は、ダブルクォーテーションで囲むことも重要です。

設定確認のポイント

・指定したファイルパスが正しいか

・アクセシビリティの部分が public もしくは private になっているか

・使用しているコマンドラインオプションが環境に適しているか

これらの点を確認することで、エラー発生の原因を特定しやすくなります。

修正手順と対策

記述修正の手順

1. コマンドラインオプションの記述を見直し、/resource や /linkresource の項目を正しい形式に修正します。
2. 指定するアクセシビリティの値を public もしくは private に変更します。
3. ファイルパスやオプションの区切り記号が正しいか確認します。

コンパイル時の確認事項

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

・他のオプションとの干渉や依存関係がないかも合わせてチェックしてください。

・修正が反映されているかビルドログを確認し、設定ミスがないか再度検証します。

環境設定の見直し

開発環境とビルド設定のチェック

開発環境の設定やビルドスクリプトに誤りがある場合も CS1906 エラーの原因となります。

以下の点を確認してください。

・統合開発環境 (IDE) のプロジェクト設定が正しく反映されているか

・独自のビルドスクリプトや自動化ツールで古い設定が参照されていないか

・環境変数やシステムパスの整合性が保たれているか

これらをチェックすることで、コンパイル時の予期せぬエラーを防止できます。

実践例の提示

修正例の比較

修正前の問題点

以下は、誤ったアクセシビリティ修飾子が原因でエラーが発生する例です。

/resource:"ErrorResource.txt",internal  // internal は無効な修飾子

この記述では、internal を指定しているためコンパイルエラー CS1906 が発生します。

修正後の正しい記述例

修正後は、アクセシビリティを public または private に変更する必要があります。

以下にサンプルコードを示します。

using System;
public class Program
{
    // Main 関数は必ず記述してください
    public static void Main(string[] args)
    {
        // サンプルのメッセージを表示します
        Console.WriteLine("コンパイラ オプションの指定が正しく修正されました。");
    }
}

サンプルコードのコンパイル時は、以下のコマンドで実行できます。

csc /resource:"ErrorResource.txt,public" Program.cs

コンパイラ オプションの指定が正しく修正されました。

エラー解消の検証方法

確認ポイントと検証方法

・修正後のビルドログに CS1906 エラーが出力されていないこと

・生成されたアセンブリに正しくリソースが組み込まれていること

・実行時に Console.WriteLine などでエラーが生じず、正常に動作すること

検証の際は、これらのポイントを順に確認し、すべて正しい状態であることを実行環境で確かめてください。

エラー防止のポイント

リソース管理の注意点

正しいアクセシビリティ設定の維持

リソース管理では、常にアクセシビリティを public または private に限定する必要があります。

プロジェクト内の全てのリソースに対して、設定が一貫しているか定期的に確認してください。

設定一貫性の確保

開発チームで複数のファイルやビルドスクリプトを管理する場合、一貫したルールを設けることが重要です。

設定ミスを防止するため、チーム内でリソース管理のガイドラインを共有する手法が有効です。

ビルド環境の整備

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

開発環境やビルドツールのアップデートに伴い、コマンドラインオプションの仕様が変更される可能性があります。

最新のドキュメントを確認し、定期的にオプションの見直しを行うよう努めてください。

開発環境設定の見直し

開発環境の設定が古い場合や、間違った設定が残っている場合、エラーの原因となることがあります。

IDE やビルドツールの環境設定を定期的に見直し、最新の状態に保つことが推奨されます。

まとめ

この記事では、C# のコンパイルエラー CS1906 の原因とその対策について解説しています。

まず、/resource および /linkresource オプションの仕組みや記述方法、アクセシビリティ修飾子の正しい指定方法を説明しました。

さらに、誤ったオプション指定によるエラー発生の具体例と、修正手順や環境設定の見直し方法、実際のサンプルコードによる検証を通して対応方法を示しました。