アセンブリ リンカ (Al.exe)

Windows Vista コンピュータで仮想化されることを回避するには、アセンブリに、要求実行レベルを指定した win32 マニフェストが含まれる必要があります。コマンド ラインから al.exe を直接使用するときには、win32 リソース ファイルにマニフェストを埋め込むことができます。または、ビルド プロセスの後の段階で mt.exe を使用してマニフェストを追加することも可能です。Visual Studio 2008 では、C# と Visual Basic のどちらのコンパイラを使用しても、win32 マニフェストはアセンブリに自動的に埋め込まれます。詳細については、「/win32manifest (カスタムの Win32 マニフェスト ファイルのインポート) (C# コンパイラ オプション)」を参照してください。

file[,target]

file (モジュール) の内容を target で名前が指定されたファイルにコピーします。コピーが完了すると、Al.exe は target をコンパイルしてアセンブリを生成します。

/link[resource]:file[,name[,target[,private]]]

リソース ファイルをアセンブリにリンクします。file によって指定されたリソースがアセンブリの一部になります。ファイルはコピーされません。file パラメータには、任意のファイル形式を指定できます。たとえば、file パラメータとしてネイティブ DLL を指定できます。このようにすると、ネイティブ DLL はアセンブリの一部になるので、グローバル アセンブリ キャッシュにインストールして、アセンブリ内のマネージ コードからアクセスできます。/linkresource コンパイラ オプションを使用して、これを実行することもできます。詳細については、「/linkresource (.NET Framework リソースへのリンク) (C# コンパイラ オプション)」を参照してください。

name パラメータは、リソースの内部識別子です。targetパラメータは、Al.exe が file をコピーする対象のパスおよびファイル名を指定します。コピーが完了すると、Al.exe は target をコンパイルしてアセンブリを生成します。既定では、リソースはアセンブリでパブリックに指定されており、他のアセンブリから参照できます。private を指定すると、そのリソースを他のアセンブリから参照できなくなります。

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

リソース ファイルだけが Al.exe に渡された場合は、出力ファイルはサテライト リソース アセンブリになります。

/algid:id

アセンブリ マニフェストを含むファイルを除き、マルチファイル アセンブリ内の全ファイルをハッシュするためのアルゴリズムを指定します。既定のアルゴリズムは CALG_SHA1 です。その他のアルゴリズムについては、プラットフォーム SDK の ALG_ID のトピックを参照してください。.NET Framework の最初のリリースでは、CALG_SHA1 および CALG_MD5 だけがサポートされています。

ハッシュ値は、アセンブリ マニフェストのファイル テーブルに格納されます。インストール時や読み込み時に、アセンブリのファイルがそのハッシュと突き合わせされてチェックされます。

このオプションは、任意のモジュールのソース コードでカスタム属性 (AssemblyAlgorithmIdAttribute) として指定することもできます。

/bugreport:filename

バグ レポート用の情報を含むファイル (filename) を作成します。

/config[uration]:text

アセンブリの Configuration フィールドに文字列を指定します。text に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。

テキストが空の文字列の場合、Win32 Configuration リソースは単一の空白として表示されます。

このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyConfigurationAttribute) として指定することもできます。

/c[ulture]:text

アセンブリに関連付けるカルチャ文字列を指定します。カルチャとして有効な値は、RFC (Internet Requests for Comments) ドキュメント 1766 『Tags for the Identification of Languages』で定義されている値です。

text に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。既定のカルチャ文字列はありません。この文字列は、リフレクションを使用して表示するために使用できます。

有効な text 文字列の詳細については、「CultureInfo」を参照してください。

このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyCultureAttribute) として指定することもできます。

/descr[iption]:text

アセンブリの Description フィールドに文字列を指定します。text に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。

/win32res を指定しないと、/description が Win32 Comments リソースとして Windows エクスプローラに表示されます。

テキストが空の文字列の場合、Win32 Comments リソースは単一の空白として表示されます。

/win32res を指定した場合は、Win32 リソース情報に対して /description は無効になります。

このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (Description) として指定することもできます。

/fileversion:version

アセンブリの File Version フィールドに文字列を指定します。この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。

/win32res を指定しないと、/fileversion が Win32 File Version リソースとして使用されます。/fileversion を指定しないと、Win32 Assembly Version リソースによって Win32 File Version リソースが設定されます。

/win32res を指定した場合は、Win32 リソースに対して /fileversion は無効になります。

このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyFileVersionAttribute) として指定することもできます。

/fullpaths

エラー メッセージで報告されるすべてのファイルについて、Al.exe が絶対パスを使用するように指定します。

/keyf[ile]:filename

アセンブリに署名するためのキー ペアまたは公開キーだけを含むファイル (filename) を指定します。コンパイラは、アセンブリ マニフェストに公開キーを挿入し、最終的なアセンブリに秘密キーで署名します。キー ファイルの生成、およびキー コンテナへのキー ペアのインストールについては、「厳密名ツール (Sn.exe)」を参照してください。

遅延署名を使用する場合は、通常、このファイルには公開キーだけが含まれ、秘密キーは含まれません。

キー ペアの公開キー情報は、アセンブリの .publickey フィールドに表示されます。

このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyKeyFileAttribute) として指定することもできます。

同じコンパイルで、コマンド ライン オプションまたはカスタム属性によって /keyfile と /keyname の両方が指定された場合、Al.exe はまず、/keyname で指定されたコンテナを検索します。成功すると、キー コンテナ内の情報を使用して、アセンブリが署名されます。キー コンテナを検出できなかった場合、Al.exe は /keyfile で指定されたファイルを検索します。ファイルが検出された場合、アセンブリはキー ファイルの情報で署名され、キー情報はキー コンテナにインストールされるため (Sn.exe の -i オプションと同様)、次のコンパイル時には /keyname オプションが有効となります。

/main:method

モジュールを実行可能ファイルに変換するときに、エントリ ポイントとして使用するメソッドの完全修飾名 (class.method) を指定します。

/out:filename

Al.exe によって生成されるファイルの名前を指定します。これは必須オプションです。

/prod[uct]:text

アセンブリの Product フィールドに文字列を指定します。text に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。

/win32res を指定しないと、/product が Win32 Product Name リソースとして Windows エクスプローラに表示されます。

テキストが空の文字列の場合、Win32 Product Name リソースは単一の空白として表示されます。

/win32res を指定した場合は、Win32 リソース情報に対して /product は無効になります。

このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyProductAttribute) として指定することもできます。

/t[arget]:lib[rary] | exe | win[exe]

出力ファイルのファイル形式として、lib[rary] (コード ライブラリ)、exe (コンソール アプリケーション)、または win[exe] (Windows ベースのアプリケーション) のいずれかを指定します。既定値は lib[rary] です。

/title:text

アセンブリの Title フィールドに文字列を指定します。text に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。

/win32res を指定しないと、/title が Win32 Description リソースとして Windows エクスプローラに表示され、アプリケーションのフレンドリ名としてシェルによって使用されます。この文字列は、複数のアプリケーションでサポートされる種類のファイルに対するショートカット メニューの [ファイルを開くアプリケーションの選択] サブメニューにも表示されます。

テキストが空の文字列の場合、Win32 Description リソースは単一の空白として表示されます。

/win32res を指定した場合は、Win32 リソース情報に対して /title は無効になります。

このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyTitleAttribute) として指定することもできます。

/v[ersion]:version

アセンブリのバージョン情報を指定します。バージョン文字列の形式は major.minor.build.revision です。既定値は 0 です。

/version を指定する場合、major も指定する必要があります。major と minor を指定する場合、build に対してアスタリスク (*) を指定できます。その場合は、build が現地時間 2000 年 1 月 1 日以降の経過日数と等しい値になり、revision が現地時間 2000 年 1 月 1 日午前 0 時以降の経過秒数を 2 で割った値と等しくなります。

major、minor、および build を指定する場合、revision に対してアスタリスクを指定できます。その場合は、revision が現地時間 2000 年 1 月 1 日午前 0 時以降の経過秒数を 2 で割った値と等しくなります。

まとめると、有効なバージョン文字列は次のようになります。

X

X.X

X.X.*

X.X.X

X.X.X.*

X.X.X.X

X は 65535 を除く unsigned short 定数 (0 ～ 65534) です。

/win32res を指定しないと、/version が Win32 Assembly Version リソースとして使用されます。

/win32res、/productversion、および /fileversion を指定しない場合、/version が Assembly Version、File Version、および Product Version Win32 リソースに対して使用されます。

/win32res を指定した場合は、Win32 リソース情報に対して /version は無効になります。

このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyVersionAttribute) として指定することもできます。

/win32res:filename

Win32 リソース (.res ファイル) を出力ファイルに挿入します。Win32 リソース ファイルは、リソース コンパイラを使用して作成できます。リソース コンパイラは、Visual C++ プログラムをコンパイルするときに呼び出されます。.res ファイルは .rc ファイルから作成されます。

/?

このツールのコマンド構文とオプションを表示します。