/resource (出力へのリソース ファイルの埋め込み) (C# コンパイラ オプション)

更新 : 2007 年 11 月

指定されたリソースを出力ファイルに埋め込みます。

/resource:filename[,identifier[,accessibility-modifier]]

引数

  • filename
    出力ファイルに埋め込む .NET Framework リソース ファイル。

  • identifier (省略可能)
    リソースの論理名。リソースの読み込みに使用します。既定値はファイルの名前です。

  • accessibility-modifier (省略可能)
    リソースのアクセシビリティ (public または private)。既定値は public です。

解説

/linkresource を使用すると、リソースがアセンブリにリンクされ、リソース ファイルは出力ファイルに追加されません。

既定では、C# コンパイラを使用して作成したリソースは、アセンブリ内で public になります。リソースを private にする場合は、private をアクセシビリティ修飾子として指定します。public と private 以外のアクセシビリティは使用できません。

filename が .NET Framework リソース ファイルである場合、たとえば Resgen.exe や開発環境で作成されたものである場合は、System.Resources 名前空間のメンバを使用してアクセスできます。詳細については、「System.Resources.ResourceManager」を参照してください。それ以外のすべてのリソースに対しては、Assembly クラスの GetManifestResource* メソッドを使用して、実行時にリソースにアクセスします。

/res/resource の省略形です。

出力ファイルにおけるリソースの順序は、コマンド ラインでの指定順序に基づいて決定されます。

Visual Studio 開発環境でこのコンパイラ オプションを設定するには

  1. プロジェクトにリソース ファイルを追加します。

  2. ソリューション エクスプローラで、埋め込むファイルを選択します。

  3. 選択したファイルの [プロパティ] ウィンドウで、[ビルド アクション] をクリックします。

  4. [ビルド アクション] を [埋め込まれたリソース] に設定します。

このコンパイラ オプションをプログラムで設定する方法については、「BuildAction」を参照してください。

使用例

in.cs をコンパイルし、リソース ファイル rf.resource をアタッチする例を次に示します。

csc /resource:rf.resource in.cs

参照

その他の技術情報

C# コンパイラ オプション

プロジェクト プロパティ (Visual Studio)