オプション | 説明 |
|---|
/algid:id | アセンブリ マニフェストを含むファイルを除き、マルチファイル アセンブリ内の全ファイルをハッシュするためのアルゴリズムを指定します。既定のアルゴリズムは CALG_SHA1 です。その他のアルゴリズムについては、プラットフォーム SDK の ALG_ID のトピックを参照してください。.NET Framework の最初のリリースでは、CALG_SHA1 および CALG_MD5 だけがサポートされています。 ハッシュ値は、アセンブリ マニフェストのファイル テーブルに格納されます。インストール時や読み込み時に、アセンブリのファイルがそのハッシュと突き合わせされてチェックされます。 このオプションは、任意のモジュールのソース コードでカスタム属性 (AssemblyAlgorithmIdAttribute) として指定することもできます。 |
/base[address]:addr | 実行時にユーザーのコンピュータに DLL を読み込む先のアドレスを指定します。オペレーティング システムにプロセス空間内で DLL を再配置させる代わりに DLL のベース アドレスを指定しておくと、アプリケーションの読み込み速度が速くなります。 |
/bugreport:filename | バグ レポート用の情報を含むファイル (filename) を作成します。 |
/comp[any]:text | アセンブリの Company フィールドに文字列を指定します。text に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。 /win32res を指定しないと、text がそのファイルの Company プロパティとして Microsoft Windows エクスプローラに表示されます。/win32res を指定すると、指定したリソース ファイル内の企業情報が Company プロパティとして Windows エクスプローラに表示されます。 テキストが空の文字列 ("") の場合、Win32 Company リソースは単一の空白として表示されます。 /win32res を指定した場合は、Win32 リソース情報に対して /company は無効になります。 このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyCompanyAttribute) として指定することもできます。 |
/config[uration]:text | アセンブリの Configuration フィールドに文字列を指定します。text に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。 テキストが空の文字列の場合、Win32 Configuration リソースは単一の空白として表示されます。 このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyConfigurationAttribute) として指定することもできます。 |
/copy[right]:text | アセンブリの Copyright フィールドに文字列を指定します。text に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。 /win32res を指定しないと、/copyright が Win32 Copyright リソースとして Windows エクスプローラに表示されます。 テキストが空の文字列の場合、Win32 Copyright リソースは単一の空白として表示されます。 /win32res を指定した場合は、Win32 リソース情報に対して /copyright は無効になります。 このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyCopyrightAttribute) として指定することもできます。 |
/c[ulture]:text | アセンブリに関連付けるカルチャ文字列を指定します。カルチャとして有効な値は、RFC (Internet Requests for Comments) ドキュメント 1766 『Tags for the Identification of Languages』で定義されている値です。 text に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。既定のカルチャ文字列はありません。この文字列は、リフレクションを使用して表示するために使用できます。 有効な text 文字列の詳細については、「CultureInfo」を参照してください。 このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyCultureAttribute) として指定することもできます。 |
/delay[sign][+|-] | アセンブリに完全に署名するか、部分的に署名するかを指定します。完全署名されたアセンブリを作成する場合は、/delaysign- を使用します。アセンブリに公開キーだけを含める場合は、/delaysign+ を使います。 アセンブリに完全に署名するように指定すると、Al.exe はマニフェスト (アセンブリ メタデータ) を含むファイルをハッシュし、秘密キーでそのハッシュに署名します。結果として得られるデジタル署名は、マニフェストを含むファイルに格納されます。アセンブリに遅延署名した場合は、署名は算出および格納されず、後で署名を追加できるようにファイル内の空間が予約されます。 既定値は /delaysign- です。 /delaysign オプションは、/keyfile または /keyname と共に使用しなければ無効になります。 たとえば、/delaysign+ を指定すると、テスト時にはアセンブリをグローバル キャッシュに格納できます。テスト後に、アセンブリに秘密キーを含めることにより、そのアセンブリに完全署名できます。 .gif) メモ : このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyDelaySignAttribute) として指定することもできます。 |
/descr[iption]:text | アセンブリの Description フィールドに文字列を指定します。text に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。 /win32res を指定しないと、/description が Win32 Comments リソースとして Windows エクスプローラに表示されます。 テキストが空の文字列の場合、Win32 Comments リソースは単一の空白として表示されます。 /win32res を指定した場合は、Win32 リソース情報に対して /description は無効になります。 このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (Description) として指定することもできます。 |
/e[vidence]:file | Security.Evidence のリソース名を持つアセンブリに file を埋め込みます。 通常のリソースに対して Security.Evidence を使用することはできません。 |
/fileversion:version | アセンブリの File Version フィールドに文字列を指定します。この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。 /win32res を指定しないと、/fileversion が Win32 File Version リソースとして使用されます。/fileversion を指定しないと、Win32 Assembly Version リソースによって Win32 File Version リソースが設定されます。 /win32res を指定した場合は、Win32 リソースに対して /fileversion は無効になります。 このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyFileVersionAttribute) として指定することもできます。 |
/flags:flags | アセンブリの Flags フィールドに値を指定します。flags に指定できる値は次のとおりです。 - 0x0000
アセンブリは side-by-side 実行をサポートしています。 - 0x0010
アセンブリは別のバージョンが同じアプリケーション ドメインで実行されている場合には実行できません。 - 0x0020
アセンブリは別のバージョンが同じプロセスで実行されている場合には実行できません。 - 0x0030
アセンブリは別のバージョンが同じコンピュータで実行されている場合には実行できません。
このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyFlagsAttribute) として指定することもできます。 |
/fullpaths | エラー メッセージで報告されるすべてのファイルについて、Al.exe が絶対パスを使用するように指定します。 |
/help | このツールのコマンド構文とオプションを表示します。 |
/keyf[ile]:filename | アセンブリに署名するためのキー ペアまたは公開キーだけを含むファイル (filename) を指定します。コンパイラは、アセンブリ マニフェストに公開キーを挿入し、最終的なアセンブリに秘密キーで署名します。キー ファイルの生成、およびキー コンテナへのキー ペアのインストールについては、「厳密名ツール (Sn.exe)」を参照してください。 遅延署名を使用する場合は、通常、このファイルには公開キーだけが含まれ、秘密キーは含まれません。 キー ペアの公開キー情報は、アセンブリの .publickey フィールドに表示されます。 このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyKeyFileAttribute) として指定することもできます。 同じコンパイルで、コマンド ライン オプションまたはカスタム属性によって /keyfile と /keyname の両方が指定された場合、Al.exe はまず、/keyname で指定されたコンテナを検索します。成功すると、キー コンテナ内の情報を使用して、アセンブリが署名されます。キー コンテナを検出できなかった場合、Al.exe は /keyfile で指定されたファイルを検索します。ファイルが検出された場合、アセンブリはキー ファイルの情報で署名され、キー情報はキー コンテナにインストールされるため (Sn.exe の -i オプションと同様)、次のコンパイル時には /keyname オプションが有効となります。 |
/keyn[ame]:text | キー ペアを保持するコンテナを指定します。これにより、公開キーがアセンブリ マニフェストに挿入され、アセンブリに署名 (厳密な名前が指定) されます。次に、Al.exe は最終的なアセンブリに秘密キーで署名します。 Sn.exe を使用して、キー ペアを生成します。 キー情報は、アセンブリの .publickey フィールドに表示されます。 空白が埋め込まれている場合は、text を二重引用符 (" ") で囲みます。 このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyKeyNameAttribute) として指定することもできます。 |
/main:method | モジュールを実行可能ファイルに変換するときに、エントリ ポイントとして使用するメソッドの完全修飾名 (class.method) を指定します。 |
/nologo | Al.exe の起動時に、著作権情報またはロゴをコマンド ラインに表示しないようにします。 |
/out:filename | Al.exe によって生成されるファイルの名前を指定します。これは必須オプションです。 |
/platform:text | コードを実行できるプラットフォーム (x86、Itanium、x64、または既定値の anycpu) のいずれかを制限します。 |
/prod[uct]:text | アセンブリの Product フィールドに文字列を指定します。text に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。 /win32res を指定しないと、/product が Win32 Product Name リソースとして Windows エクスプローラに表示されます。 テキストが空の文字列の場合、Win32 Product Name リソースは単一の空白として表示されます。 /win32res を指定した場合は、Win32 リソース情報に対して /product は無効になります。 このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyProductAttribute) として指定することもできます。 |
/productv[ersion]:text | アセンブリの Product Version フィールドに文字列を指定します。text に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。 /win32res を指定しないと、/productversion が Win32 Product Version リソースとして使用されます。/productversion を指定しないと、Win32 File Version リソースによって Win32 Product Version リソースが設定されます。 /win32res を指定した場合は、Win32 リソース情報に対して /productversion は無効になります。 このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyInformationalVersionAttribute) として指定することもできます。 |
/t[arget]:lib[rary] | exe | win[exe] | 出力ファイルのファイル形式として、lib[rary] (コード ライブラリ)、exe (コンソール アプリケーション)、または win[exe] (Windows ベースのアプリケーション) のいずれかを指定します。既定値は lib[rary] です。 |
/template:filename | カルチャ フィールドを除く、すべてのアセンブリ メタデータの継承元であるアセンブリ (filename) を指定します。 /template を指定して作成したアセンブリは、サテライト アセンブリになります。 |
/title:text | アセンブリの Title フィールドに文字列を指定します。text に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。 /win32res を指定しないと、/title が Win32 Description リソースとして Windows エクスプローラに表示され、アプリケーションのフレンドリ名としてシェルによって使用されます。この文字列は、複数のアプリケーションでサポートされる種類のファイルに対するショートカット メニューの [ファイルを開くアプリケーションの選択] サブメニューにも表示されます。 テキストが空の文字列の場合、Win32 Description リソースは単一の空白として表示されます。 /win32res を指定した場合は、Win32 リソース情報に対して /title は無効になります。 このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyTitleAttribute) として指定することもできます。 |
/trade[mark]:text | アセンブリの Trademark フィールドに文字列を指定します。text に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。 /win32res を指定しないと、/trademark が Win32 Trademark リソースとして Windows エクスプローラに表示されます。 テキストが空の文字列の場合、Win32 Trademark リソースは単一の空白として表示されます。 /win32res を指定した場合は、Win32 リソース情報に対して /trademark は無効になります。 このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyTrademarkAttribute) として指定することもできます。 |
/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) として指定することもできます。 |
/win32icon:filename | .ico ファイルをアセンブリに挿入します。この .ico ファイルは、Windows エクスプローラにおける出力ファイルの視覚的な表現を提供します。 |
/win32res:filename | Win32 リソース (.res ファイル) を出力ファイルに挿入します。Win32 リソース ファイルは、リソース コンパイラを使用して作成できます。リソース コンパイラは、Visual C++ プログラムをコンパイルするときに呼び出されます。.res ファイルは .rc ファイルから作成されます。 |
@filename | Al.exe コマンドが格納されている応答ファイルを指定します。 応答ファイルでは、コマンドは各行に 1 つずつ指定されるか、複数のコマンドが 1 行に空白で区切られて指定されます。 |
/? | このツールのコマンド構文とオプションを表示します。 |