共用方式為


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。 如果您指定 majorminor,您可以針對 build指定星號 。。 這樣一來,build 就相當於自當地時間 2000 年 1 月 1 日起算的天數,而 revision 則等於自當地時間當天午夜起算的秒數除以 2。

如果您指定 majorminorbuild,則可以指定星號代表 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 選項指定方法,但是該方法不是靜態、未傳回 intvoid、為泛型,或具有無效的引數。
al1042 'exe': 無法將 EXE 加入模組

已將不含組件的 .exe 檔指定為 Al.exe 的輸入檔。 Al.exe 只能將不含組件的 .dll 檔案當作輸入檔。
al1043 資訊清單檔名 'name' 不可與任何模組相同

使用 /out 選項指定的名稱不能與指定為 Al.exe 輸入的任何一個檔案名稱相同。
al1044 讀取金鑰檔 'file' 時發生錯誤— 原因

從使用 /keyfileAssemblyKeyFileAttribute 指定的檔案中開啟或讀取時發生錯誤。
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

另請參閱