Al.exe (組件連結器)
組件連結器 (Assembly Linker) 會從一個或多個模組或資源檔中產生一個包含組件資訊清單的檔案。 模組是不包含組件資訊清單的中繼語言 (IL) 檔案。
注意
從 Visual Studio 2008 開始，C# 和 Visual Basic 編譯器都會自動將 Win32 資訊清單嵌入組件中。 如需詳細資訊，請參閱 -win32manifest （C# 編譯程序選項）。
此工具會自動與 Visual Studio 一起安裝。 若要執行此工具，請使用 Visual Studio 開發人員命令提示字元或 Visual Studio Developer PowerShell。
在命令提示字元上鍵入下列字行：
語法
al sources options
參數
您可以指定一個或多個下列 sources。
| 來源 | 描述 |
|---|---|
file[，target] |
將 file (模組) 的內容複製到 target 所指定的檔案名稱中。 複製完成後，Al.exe 會將 target 編譯成組件。 |
/embed[resource]： file[，name[，private]] |
將 file 所指定的資源嵌入包含組件資訊清單的映像中，Al.exe 會將 file 的內容複製到可攜式執行檔 (PE) 映像中。name 參數是資源的內部識別項。 根據預設，組件中的資源為公用 (其他組件也可看見)。 指定 private 會使其他組件無法看見資源。例如，如果 file 是由資源檔產生器 (Resgen.exe) 或是在開發環境中所建立的 .NET Framework 資源檔，就可以使用 System.Resources 中的成員進行存取。 如需詳細資訊，請參閱ResourceManager。 對於所有其他資源，請使用 GetManifestResource* 中的 Assembly 方法，在運行時間存取資源。如果只將資源檔傳遞至 Al.exe，則輸出檔案會是附屬資源組件。 |
/link[resource]： file[，name[，target[，private]]] |
將資源檔連結至組件。 file 所指定的資源會變成組件的一部分，但是不會複製檔案。 file 參數可以是任何檔案格式。 例如，您可以指定原生 DLL 做為 file 參數。 這樣就會產生組件的原生 DLL 部分，以便安裝到全域組件快取中，並從組件的 Managed 程式碼存取。 您也可以利用 /linkresource 編譯器選項，進行上述作業。 如需詳細資訊，請參閱 -linkresource （C# 編譯程序選項）。name 參數是資源的內部識別項。 參數target會指定Al.exe複製file的路徑和檔名。複製之後，Al.exe編譯target成元件。 根據預設，組件中的資源為公用 (其他組件也可看見)。 指定 private 會使其他組件無法看見資源。例如，如果 file 是由資源檔產生器 (Resgen.exe) 或是在開發環境中所建立的 .NET Framework 資源檔，就可以使用 System.Resources 命名空間中的成員進行存取。 如需詳細資訊，請參閱ResourceManager。 對於其他所有資源，請使用 Assembly 類別中的 GetManifestResource* 方法，以在執行階段存取資源。如果只將資源檔傳遞至 Al.exe，則輸出檔案會是附屬資源組件。 |
您可以指定下列 options，但是必須指定 /out。
| 選項 | 描述 |
|---|---|
/algid： id |
指定雜湊多檔案組件中所有檔案的演算法，但包含組件資訊清單的檔案除外。 預設演算法為 CALG_SHA1。 如需其他演算法，請參閱 Platform SDK 文件中的 ALG_ID。 對於第一版 .NET Framework，只有 CALG_SHA1 和 CALG_MD5 有效。 雜湊值儲存在組件資訊清單的檔案表中。 在安裝和載入期間，系統會根據雜湊來檢查組件的檔案。 您也可以在任何模組的原始程式碼中，指定這個選項做為自訂屬性 (AssemblyAlgorithmIdAttribute)。 |
/base[address]： addr |
指定在執行期間將 DLL 載入使用者電腦上的目標位址。 如果您指定 DLL 的基底位址，而不是讓作業系統重新找出處理序空間中的 DLL，應用程式載入的速度會更快。 |
/bugreport: filename |
建立包含回報 Bug 所需資訊的檔案 (filename)。 |
/comp[any]： text |
為組件中的 [公司] 欄位指定字串。 如果 text 包含空格，請將字串置於雙引號內 (" ")。 這個字串是組件的自訂屬性，可使用反映進行檢視。如不指定 /win32res，檔案總管就會將 text 顯示為檔案的 Company 屬性。 如果指定 /win32res，檔案總管就會將特定資源檔中的公司資訊顯示為 Company 屬性。如果文字為空字串 ("")，Win32 Company 資源會顯示為單一空格。如果指定 /win32res，/company 就不會影響 Win32 資源資訊。 您也可以在任何 CIL 模組的原始程式碼中，將此選項指定為自訂屬性 （AssemblyCompanyAttribute）。 |
/config[uration]： text |
為組件中的 [組態] 欄位指定字串。 如果 text 包含空格，請將字串置於雙引號內 (" ")。 這個字串是組件的自訂屬性，可使用反映進行檢視。如果文字為空字串，Win32 Configuration 資源會顯示為單一空格。 您也可以在任何 CIL 模組的原始程式碼中，將此選項指定為自訂屬性 （AssemblyConfigurationAttribute）。 |
/copy[right]： text |
為組件中的 [著作權] 欄位指定字串。 如果 text 包含空格，請將字串置於雙引號內 (" ")。 這個字串是組件的自訂屬性，可使用反映進行檢視。如不指定 /win32res，檔案總管會將 /copyright 顯示為 Win32 Copyright 資源。 如果文字為空字串，Win32 Copyright 資源會顯示為單一空格。 如果指定 /win32res，/copyright 就不會影響 Win32 資源資訊。 您也可以在任何 CIL 模組的原始程式碼中，將此選項指定為自訂屬性 （AssemblyCopyrightAttribute）。 |
/c[ulture]： text |
指定與組件相關聯的文化特性字串。 文化特性的有效值為標題＜Tags for the Identification of Languages＞的＜Internet Requests for Comments (RFC) 1766＞文件中定義的值。 如果 text 包含空格，請將字串置於雙引號內 (" ")。 沒有預設的文化特性字串。 這個字串可使用反映進行檢視。如需有效 text 字串的詳細資訊，請參閱 CultureInfo。您也可以在任何 CIL 模組的原始程式碼中，將此選項指定為自訂屬性 （AssemblyCultureAttribute）。 |
/delay[sign][+ or -] |
指定將要完整簽署還是部分簽署組件。 如果需要完整簽署的組件，請使用 /delaysign-。 如果只想在組件中包含公開金鑰，請使用 /delaysign+。 當您要求完整簽署的組件時，Al.exe 會雜湊包含資訊清單 (組件中繼資料) 的檔案，並使用私密金鑰簽署該雜湊。 所產生的數位簽章會儲存在包含資訊清單的檔案中。 當組件延遲簽署時，Al.exe 不會計算和儲存該簽章，只會在檔案中保留空間，以便之後再新增該簽章。 預設值為 /delaysign-。 /delaysign 選項必須搭配 /keyfile 或 /keyname 才有作用。 例如，使用 /delaysign+ 時，可讓測試人員將組件放入全域快取中。 測試過後，您就可以將私密金鑰包含在組件內，藉此完整簽署組件。 注意：在使用 Gacutil.exe (全域組件快取工具) 將延遲簽署的組件放入全域快取之前，請先使用 Sn.exe (強式名稱工具) 註冊這個組件，以略過驗證。 例如： Sn.exe –Vr delaySignedAssembly 。 這種方式僅適用於開發工作。您也可以在任何 CIL 模組的原始程式碼中，將此選項指定為自訂屬性 （AssemblyDelaySignAttribute）。 |
/descr[iption]： text |
為組件中的 [Description] 欄位指定字串。 如果 text 包含空格，請將字串置於雙引號內 (" ")。 這個字串是組件的自訂屬性，可使用反映進行檢視。如不指定 /win32res，檔案總管會將 /description 顯示為 Win32 Comments 資源。 如果文字為空字串，Win32 Comments 資源會顯示為單一空格。 如果指定 /win32res，/description 就不會影響 Win32 資源資訊。 您也可以在任何 CIL 模組的原始程式碼中，將此選項指定為自訂屬性 （Description）。 |
/e[vidence]： file |
使用 Security.Evidence 的資源名稱將 file 嵌入組件中。Security.Evidence 無法用於一般資源。 |
/fileversion： version |
為組件中的 [檔案版本] 欄位指定字串。 這個字串是組件的自訂屬性，可使用反映進行檢視。 如不指定 /win32res，系統會將 /fileversion 作為 Win32 File Version 資源。 如不指定 /fileversion，系統會在 Win32 File Version 資源中填入 Win32 Assembly Version 資源。 如果指定 /win32res，則 /fileversion 不會影響 Win32 資源。 您也可以在任何 CIL 模組的原始程式碼中，將此選項指定為自定義屬性 （AssemblyFileVersionAttribute）。 |
/標誌： flags |
為組件中的 [Flags] 欄位指定值。 flags 的可能值如下：0x0000 組件可並存相容。 0x0010 如果組件在相同的應用程式定義域中執行時，就無法與其他版本一起執行。 0x0020 如果組件在相同的處理序中執行，就無法與其他版本一起執行。 0x0030 如果組件與其他版本位於同一部電腦上，就無法與其他版本一起執行。 您也可以在任何 CIL 模組的原始程式碼中，將此選項指定為自訂屬性 （AssemblyFlagsAttribute）。 |
| /fullpaths | 讓 Al.exe 使用錯誤訊息中所報告之任何檔案的絕對路徑。 |
| /help | 顯示工具的命令語法和選項。 |
/keyf[ile]： filename |
指定包含金鑰組或只有公開金鑰的檔案 (filename)，用以簽署組件。 編譯器會將公開金鑰插入組件資訊清單中，然後使用私密金鑰簽署最終組件。 如需如何產生金鑰檔案以及將金鑰組安裝在金鑰容器中的資訊，請參閱強式名稱工具 (Sn.exe)。如果您使用延遲簽署，這個檔案通常會包含公開金鑰，但不會包含私密金鑰。 (金鑰組的) 公開金鑰資訊會出現在組件的 [.publickey] 欄位中。 您也可以在任何 CIL 模組的原始程式碼中，將此選項指定為自訂屬性 （AssemblyKeyFileAttribute）。 如果在相同編譯中同時指定 /keyfile 和 /keyname (藉由命令列選項或是自訂屬性指定)，Al.exe 會先嘗試使用 /keyname 指定的容器。 如果這個動作成功，那麼組件就會使用金鑰容器中的資訊進行簽署。 如果 Al.exe 找不到金鑰容器，則會嘗試使用 /keyfile 指定的檔案。 如果這個動作成功，系統就會使用金鑰檔中的資訊簽署組件，並將金鑰資訊安裝在金鑰容器中 (類似於 Sn.exe 中的 -i 選項)，這樣在下次編譯時，/keyname 選項就會是有效的。 |
/keyn[ame]： text |
指定保留金鑰組的容器。 這樣會藉由將公開金鑰插入組件資訊清單中的方式簽署組件 (為它指定強式名稱)。 Al.exe 接著會使用私密金鑰簽署最終組件。 請使用 Sn.exe 產生金鑰組。 金鑰資訊會出現在組件的 [.publickey] 欄位中。 如果有內嵌空格，請將 text 置於雙引號 (" ") 內。您也可以在任何 CIL 模組的原始程式碼中，將此選項指定為自訂屬性 （AssemblyKeyNameAttribute）。 |
/主要： method |
指定將模組轉換成可執行檔時，用來做為進入點之方法的完整名稱 (class.method)。 |
| /nologo | 隱藏叫用 Al.exe 時命令列中顯示的橫幅或標誌。 |
/外： filename |
指定 Al.exe 所產生檔案的名稱。 這是必要選項。 |
/平臺： text |
限制可以執行這個程式碼的平台，這個平台必須下列其中之一：x86、Itanium、x64、anycpu (預設值) 或 anycpu32bitpreferred。 |
/prod[uct]： text |
為組件中的 [產品] 欄位指定字串。 如果 text 包含空格，請將字串置於雙引號內 (" ")。 這個字串是組件的自訂屬性，可使用反映進行檢視。如不指定 /win32res，檔案總管就會將 /product 顯示為 Win32 Product Name 資源。 如果文字為空字串，Win32 Product Name 資源會顯示為單一空格。 如果指定 /win32res，/product 就不會影響 Win32 資源資訊。 您也可以在任何 CIL 模組的原始程式碼中，將此選項指定為自訂屬性 （AssemblyProductAttribute）。 |
/productv[ersion]： text |
為組件中的 [產品版本] 欄位指定字串。 如果 text 包含空格，請將字串置於雙引號內 (" ")。 這個字串是組件的自訂屬性，可使用反映進行檢視。如不指定 /win32res，系統就會將 /productversion 作為 Win32 Product Version 資源。 如不指定 /productversion，系統會在 Win32 Product Version 資源中填入 Win32 File Version 資源。 如果指定 /win32res，/productversion 就不會影響 Win32 資源資訊。 您也可以在任何 CIL 模組的原始程式碼中，將此選項指定為自訂屬性 （AssemblyInformationalVersionAttribute）。 |
/t[arget]： lib[rary] | exe | win[exe] |
指定輸出檔的檔案格式：lib[rary] (程式碼程式庫)、exe (主控台應用程式) 或 win[exe] (Windows 應用程式)。 預設值為 lib[rary]。 |
/範本： filename |
指定要從其中繼承所有組件中繼資料的組件 filename，但不包括 [文化特性] 欄位。使用 /template 建立的組件會是附屬組件。 |
/標題： text |
為組件中的 [標題] 欄位指定字串。 如果 text 包含空格，請將字串置於雙引號內 (" ")。 這個字串是組件的自訂屬性，可使用反映進行檢視。如不指定 /win32res，檔案總管會將 /title 顯示為 Win32 Description 資源，而殼層將使用此資源作為應用程式的易記名稱。 如果檔案類型具有多個支援應用程式，則該檔案類型之捷徑功能表的 [開啟方式] 子功能表中也會顯示此項目。 如果文字為空字串，Win32 Description 資源會顯示為單一空格。 如果指定 /win32res，/title 就不會影響 Win32 資源資訊。 您也可以在任何 CIL 模組的原始程式碼中，將此選項指定為自訂屬性 （AssemblyTitleAttribute）。 |
/trade[mark]： text |
為組件中的 [商標] 欄位指定字串。 如果 text 包含空格，請將字串置於雙引號內 (" ")。 這個字串是組件的自訂屬性，可使用反映進行檢視。如不指定 /win32res，檔案總管會將 /trademark 顯示為 Win32 Trademark 資源。 如果文字為空字串，Win32 Trademark 資源會顯示為單一空格。 如果指定 /win32res，/trademark 就不會影響 Win32 資源資訊。 您也可以在任何 CIL 模組的原始程式碼中，將此選項指定為自訂屬性 （AssemblyTrademarkAttribute）。 |
/v[ersion]： version |
指定這個組件的版本資訊。 版本字串的格式為 major.minor.build.revision。預設值為 0。如果指定 /version，則必須同時指定 major。 如果您指定 major 和 minor，您可以針對 build指定星號 。。 這樣一來，build 就相當於自當地時間 2000 年 1 月 1 日起算的天數，而 revision 則等於自當地時間當天午夜起算的秒數除以 2。如果您指定 major、minor 和 build，則可以指定星號代表 revision。 這樣一來，revision 就等於自當地時間當天午夜起算的秒數除以 2。簡單來說，有效的版本字串如下： X X.X X.X.* X.X.X X.X.X.* X.X.X.X 其中 X 是指任何不帶正負號的簡短常數，但 65535 除外 (0-65534)。 如不指定 /win32res，系統會將 /version 作為 Win32 Assembly Version 資源。 如不指定 /win32res、/productversion 和 /fileversion，系統會將 /version 作為 Win32 Assembly Version、File Version 和 Product Version 資源。 如果指定 /win32res，/version 就不會影響 Win32 資源資訊。 您也可以在任何 CIL 模組的原始程式碼中，將此選項指定為自訂屬性 （AssemblyVersionAttribute）。 |
/win32icon： filename |
將 .ico 檔案插入組件中。 .ico 檔案會讓輸出檔案在檔案總管中以所要的外觀顯示。 |
/win32res： filename |
將 Win32 資源 (.res 檔案) 插入輸出檔案中。 您可以使用資源編譯器建立 Win32 資源檔。 資源編譯器是在編譯 Visual C++ 程式時叫用，而 .res 檔案則是從 .rc 檔案建立。 |
@filename |
指定包含 Al.exe 命令的回應檔。 回應檔中的命令可顯示為一行一個，也可以全部顯示在同一行，並以一個或多個空格加以分隔。 |
| /? | 顯示工具的命令語法和選項。 |
備註
所有 Visual Studio 編譯器都會產生組件。 但是，如果您有一或多個模組 (不具資訊清單的中繼資料)，就可以使用 Al.exe 在另一個檔案中建立包含資料清單的組件。
若要在快取中安裝組件、從快取中移除組件，或是列出快取的內容，請使用全域組件快取工具 (Gacutil.exe)。
錯誤和警告
下表列出 Al.exe 所產生的錯誤。
| 錯誤 | 描述 |
|---|---|
| al1001 | 內部編譯器錯誤 請嘗試判斷 Al.exe 失敗的原因是否為無法剖析未預期的語法。 然後，請連絡 Microsoft 產品支援服務。 |
| al1002 | 記憶體不足 Al.exe 因記憶體不足而停止。 請增加可用記憶體的數量。 |
| al1003 | 編譯器選項 'option' 後面必須使用引數 Al.exe 必須有傳遞至命令列選項的引數。 例如，如果指定 /algid:，則必須傳遞演算法識別項。 |
| al1004 | 未預期的 Common Language Runtime 初始化錯誤 — 'reason' Al.exe 回報因指定的原因而造成 Visual Studio 或通用語言執行平台安裝錯誤。 |
| al1005 | 檔案 'file' 太大，無法開啟 Al.exe 開啟的所有檔案都必須小於 4GB。 |
| al1006 | 已經包含回應檔 'file' 相同的回應檔 ( @file) 在命令列中指定多次。 回應檔只能包含一次。 |
| al1007 | 開啟回應檔 'file' 時發生錯誤 — 'reason' Al.exe 因指定的原因而無法開啟指定的回應檔。 |
| al1008 | 遺漏 'option' 命令列選項的檔案規格 Al.exe 必須有傳遞至命令列選項的檔案。 例如，如果指定 /out 選項，則必須指定檔案。 |
| al1009 | 無法開啟 'file' 進行寫入 Al.exe 無法寫入檔案，例如輸出組件檔。 可能是磁碟已滿、檔案為唯讀，或沒有檔案的權限。 |
| al1010 | 命令列語法錯誤: 遺漏 'option' 選項的 ':text' Al.exe 必須有傳遞至命令列選項的引數。 例如，如果指定 /title 選項，則必須傳遞字串。 |
| al1011 | 檔案 'file' 是可執行檔，無法當做文字檔開啟 必須是文字檔，但卻指定了二進位檔。 例如，如果在命令列上將二進位檔當做回應檔傳遞，便會發生這個錯誤。 |
| al1012 | 'value' 不是選項 'option' 的有效設定 傳遞至命令列選項的值是未預期的值。 例如，如果指定給 /target 選項的值無效，便會發生這個錯誤。 |
| al1013 | 無法辨認的命令列選項: 'option' 指定的命令列選項無效。 |
| al1014 | 未預期的初始化錯誤 — 'reason' Al.exe 偵測到 COM 初始化失敗。 可能是由於記憶體不足所造成，更可能的原因是系統的 DLL 檔案。 如果執行任何自動化感知或 COM 感知程式 (例如 Microsoft Visual Studio)，可能會看見類似的錯誤。 請重新安裝作業系統。 |
| al1015 | 找不到訊息檔案 'alinkui.dll' Al.exe 需要 Alinkui.dll。 請確定這個檔案在路徑中。 如有必要，請從產品光碟複製這個檔案。 |
| al1016 | 未指定有效的輸入檔 Al.exe 需要一或多個不含組件資訊的輸入檔。 |
| al1017 | 未指定目標檔名 遺漏指定目標檔名的必要 /out 選項。 |
| al1018 | 無法載入必要的檔案 'file' 無法載入特定 DLL 檔。 重新安裝 Visual Studio 或 Windows SDK。 |
| al1019 | 建立元件時的元數據失敗 — 原因 產生組件時因指定原因而中斷。 例如，如果找不到使用 /win32res 選項指定的檔案，便會發生這個錯誤。 |
| al1020 | 忽略包含的組件 'file' 指定的輸入檔包含組件。 Al.exe 輸入檔不能包含組件。 |
| al1021 | 'setting' : 正在覆寫先前的設定 模組具有可能透過自訂屬性指派的特定設定值，但使用 Al.exe 命令列選項傳遞的值已加以覆寫。 |
| al1022 | 讀取內嵌資源 'file' 時發生錯誤— 原因 Al.exe 因指定的原因而無法讀取傳遞至 /embedresource 選項的檔案。 |
| al1023 | 內嵌資源 'file' 時發生錯誤— 原因 作業系統因指定原因而無法將資源檔嵌入組件中。 |
| al1025 | ComType 記錄 'record' 指向無效的檔案記錄 'record' 輸入模組中的中繼資料無效。 產生模組的工具必須固定。 |
| al1026 | 指定的版本 'version' 無效 如需有效的格式，請參閱 /version 選項的資訊。 |
| al1028 | 金鑰檔 'file' 遺漏簽署所需的私密金鑰 傳遞至 /keyfile 選項的金鑰檔只包含公開金鑰。 請使用強式名稱工具 (Sn.exe)，以產生同時包含公開金鑰和私密金鑰的檔案，如下列命令所示。 sn -k keypair.snk. |
| al1029 | 金鑰容器名稱 'container' 不存在 傳遞至 /keyname 選項的值不是有效的容器。 請使用強式名稱工具 (Sn.exe) 建立容器。 |
| al1030 | 未妥善安裝密碼編譯服務或缺乏適當的金鑰提供者 您可能需要重新安裝作業系統，或安裝一些用來建立金鑰的密碼編譯公用程式。 |
| al1031 | 讀取圖示 『file』 時發生錯誤— 原因 Al.exe 因指定的原因而無法讀取傳遞至 /win32icon 選項的檔案 |
| al1032 | 產生 「檔案」資源時發生錯誤— 原因 Al.exe 因磁碟空間不足或某些其他錯誤而無法建立檔案。 當您指定 /win32icon 選項 (以產生 .ico 檔) 或未指定 /win32res 選項 (以產生包含資源資訊的檔案) 時，便會發生這個錯誤。 如果您無法解決檔案產生的相關問題，請使用 /win32res，以指定可包含版本或點陣圖 (圖示) 資訊的檔案。 |
| al1033 | 已經多次以不同的值指定組件自訂屬性 'attribute' 在指定為 Al.exe 輸入的來源模組中，不同的值已傳遞給相同自訂屬性的兩個項目。 |
| al1034 | 組件 'file' 無法被複製或重新命名 雖然使用 Al.exe 語法可讓您指定和複製輸入檔，但是會發生名稱衝突，使編譯器停止。 例如，如果您指定 input.dll,somename.dll /out:somename.dll，便會發生這個錯誤。 |
| al1035 | 程式庫無法有進入點 您無法同時指定 /target:lib 選項 (預設值) 和 /main 選項。 |
| al1036 | 可執行應用程式必須有進入點 使用 /target:exe 或 /target:win 選項時，也必須指定 /main 選項。 |
| al1037 | 找不到進入點方法 'main' Al.exe 在 /main 選項所指定的位置找不到 Main 方法。 |
| al1039 | 全域程式集緩存管理員初始化失敗 — 原因 重新安裝 Visual Studio 或 Windows SDK。 |
| al1040 | 無法將元件安裝至快取 - 原因 只有簽署的組件才能安裝至快取。 如需詳細資訊，請參閱全域組件快取。 |
| al1041 | 'method': 因為簽章或可見度不正確，或者其為泛型，所以無法成為進入點 已使用 /main 選項指定方法，但是該方法不是靜態、未傳回 int 或 void、為泛型，或具有無效的引數。 |
| al1042 | 'exe': 無法將 EXE 加入模組 已將不含組件的 .exe 檔指定為 Al.exe 的輸入檔。 Al.exe 只能將不含組件的 .dll 檔案當作輸入檔。 |
| al1043 | 資訊清單檔名 'name' 不可與任何模組相同 使用 /out 選項指定的名稱不能與指定為 Al.exe 輸入的任何一個檔案名稱相同。 |
| al1044 | 讀取金鑰檔 'file' 時發生錯誤— 原因 從使用 /keyfile 或 AssemblyKeyFileAttribute 指定的檔案中開啟或讀取時發生錯誤。 |
| al1045 | 檔名 'file' 太長或無效 傳遞至 Al.exe 的檔案名稱超過 260 個字元。 請選擇字元較少或路徑較短的檔名，或重新命名檔案。 |
| al1046 | 在這個組件中已經使用過資源識別項 'ID' 兩個內嵌或連結的資源具有相同的識別項或名稱 (第二個引數)。 請將其中一個衝突的資源移除或重新命名。 |
| al1047 | 匯入檔案 'file' 時發生錯誤— 原因 模組檔案因指定原因而無法開啟。 |
| al1048 | 匯入元件 'assembly' 的模組 'module' 時發生錯誤— 原因 開啟多檔案組件的非資訊清單檔時發生錯誤。 這個錯誤並不是由 Al.exe 直接發出，但是可以利用程式設計方式傳遞至使用 Al.exe 的處理序。 |
| al1049 | 無法自動產生日期早於 2000 年 1 月 1 日的組建與修訂版本號碼 電腦上所設定的系統時間日期早於 2000 年 1 月 1 日。 |
| al1050 | 不再支援您正使用的 'old feature' 功能; 請改用 'new feature' Al.exe 先前支援的功能已淘汰。 請改用建議的功能。 |
| al1051 | 發出 'attribute' 屬性時發生錯誤— 原因 Al.exe 因指定的原因而未處理組件自訂屬性。 |
| al1052 | 檔案 'filename' 不是組件 使用 /template 指定的檔案必須包含組件中繼資料。 這個錯誤表示 /template 指定的檔案先前並未包含組件。 |
| al1053 | 版本 'version' (指定給 'option') 不是使用一般的 'major.minor.build.revision' 格式 Al.exe 偵測到使用 /fileversion 或 /productversion 選項指定的版本資訊格式錯誤。 |
| al1054 | 版本 'version' (指定給 'option') 不是使用一般的 'major.minor.build.revision' 格式 Al.exe 偵測到使用 SatelliteContractVersionAttribute 指定的版本資訊格式錯誤。 |
| al1055 | 參考的組件 'filename' 沒有強式名稱 當您建置包含強式名稱的組件，但是卻參考不含強式名稱的組件時，便會發生這個錯誤。 若要修正這個錯誤，您必須使用強式名稱重新產生組件，或者使用 Sn.exe 將強式名稱附加到組件 (請參閱 sn.exe 的文件)。 透過包裝函式組件使用 COM 物件時，通常會發生這個錯誤，例如透過 Visual Studio IDE 在 C# 專案的 COM 模組中加入參考時。 若要避免發生這個錯誤，您可以在 [包裝函式組件金鑰檔/名稱] 專案屬性中指定 COM 包裝函式組件的強式名稱金鑰檔。 如果要透過 tlbimp 建立包裝函式組件，請參閱 tlbimp 文件，以取得如何將強式名稱指派給包裝函式組件的相關資訊。 如果組件有強式名稱，便可將它安裝在全域組件快取中。 因此，參考的組件也需要進入全域組件快取中。 只有包含強式名稱的組件才能進入全域組件快取中。 |
| al1056 | 參考的組件 'filename' 是當地語系化的附屬組件 在建立目前的組件時參考到使用 AssemblyCultureAttribute 屬性建立的組件。 AssemblyCultureAttribute 屬性表示檔案是當地語系化的附屬組件，不適合參考附屬組件。 請改為參考主要父元件。 |
| al1057 | 可執行檔無法被當地語系化，文化特性需保持空白 組件是使用 /target:exe 建立的，但指定的卻是 /culture。 .exe 中的組件在 [文化特性] 欄位中不能包含資訊。 |
| al1058 | 'file' 是組件，而且無法加入為模組 在 C++ 編譯中，已將包含組件的檔案傳遞至 /assemblymodule (連結器選項)。 |
| al1059 | 未知的錯誤 (code) Al.exe 收到未知的錯誤碼 ( code)。可能的解決方法包括： 請重新安裝 Visual Studio。 重新安裝 Windows SDK。 檢查是否有遺漏的檔案。 檢查是否有足夠的磁碟空間。 檢查是否有足夠的記憶體。 停止其他可能會存取檔案的處理序。 重新啟動電腦。 |
| al1060 | 建立哈希時的密碼編譯失敗 — 原因 為多檔案組件建立檔案雜湊時發生錯誤。 |
| al1061 | 無法設定選項 'option'，因為 'reason' 為這個選項指定的值因指定原因無效。 |
| al1062 | 模組 'module' 已經被指定多次; 它只能被包括一次 這個警告會在相同的來源、輸入或模組檔案於命令列上多次指定時產生。 請確定您只指定一次檔案名稱。 |
| al1063 | 在這個組件中公用類型 'type' 已於多個位置定義: 'file1' 和 'file2' 在組件的多個模組中找到同一個類型。 組件中每個類型只能有一個版本。 |
| al1064 | 無法指定多個 /bugreport 選項。 只允許一個 /bugreport 選項。 |
| al1065 | 檔名 'File Name' 太長或無效 指定的檔名超過允許的上限。 |
| al1066 | 命令行或回應檔中不允許字元 'character' 在命令列或檔案中找到無效的字元。 |
| al1067 | 'filename' 是二進位檔，不是文字檔 這個檔案是二進位格式，不是文字格式。 |
| al1068 | 在這個組件中已經定義模組 'ModuleName'。 每個連結資源和模組必須具有唯一的檔名。 該模組在這個組件中出現一次以上。 |
| al1069 | 無法建立短檔名 'filename'，因為已經有個長檔名具有相同的短檔名 目前檔案的名稱是另一個已存在檔名的簡短版本。 例如，編譯 LongFileName.cs 後再以 LongFi~1.cs 名稱重新編譯，便會造成類似的編譯器錯誤。 如果已刪除具有長名稱的編譯器輸出檔，但類比連結器檔案還存在，便會發生這個錯誤。 |
| al1070 | 無從驗證元件不能有處理器特定的模組 'Module Name' 如果您要使用 /platform：agnostic 建置 （或未指定 /platform），如果您嘗試新增模組（使用 /addmodule）而非無從驗證，就會產生錯誤。 這類似嘗試將 i386 obj 檔連結至 ia64 obj。 非無從驗證模組的主要來源為 C++。 如果您搭配 C++ 模組使用 /addmodule，可能必須修改建置指令碼，以指定適當的 /platform 設定。 |
| al1072 | 組件和模組 'Module Name' 的目標處理器不能不同 您無法將目標為不同處理器的組件和模組連結在一起，因為結果必須在單一處理器上執行。 |
| al1073 | 參考的組件 'assembly' 以不同的處理器為目標 您無法將目標為不同處理器的組件連結在一起，因為結果必須在單一處理器上執行。 |
| al1074 | 儲存於 'File Name' 的模組名稱 'Module Name' 必須符合其檔名 這是連結器的必要條件。 若要解決這個問題，請讓這兩個名稱相符。 |
| al1075 | 要求延遲簽署，但未提供金鑰 當延遲簽署組件時，編譯器不會去計算和儲存簽章，但會保留檔案中的空間，以便稍後再加入簽章。 例如，使用 /delaysign+ 時，可讓測試人員將組件放入全域快取中。 測試之後，您可以使用 Assembly Linker 公用程式將私密金鑰加入組件，以完整簽署組件。 |
| al1076 | 類型 'type' 會轉送至多個組件: 'assembly' 和 'assembly'。 類型只能轉送至一個組件。 |
| al1077 | 公用類型 'type' 定義於 'assembly' 中並轉送至 'assembly'。 所產生的組件中有重複的公用類型。 其中一個是有效的類型定義，另一個是類型轉送子。 |
範例
下列命令會使用 t2.netmodule 模組中的組件建立可執行檔 t2a.exe。 進入點是 Main 中的 MyClass 方法。
al t2.netmodule /target:exe /out:t2a.exe /main:MyClass.Main
