RegisterAssembly 工作
更新:2007 年 11 月
讀取指定組件內的中繼資料 (Metadata),並將必要項目加入到可讓 COM 用戶端以透明方式建立 .NET Framework 類別的登錄中。此工作的行為類似於 (但不完全相同) 組件登錄工具 (Regasm.exe) 的行為。
參數
下表說明 RegisterAssembly 工作的參數。
參數 |
描述 |
---|---|
Assemblies |
必要的 ITaskItem[] 參數。 指定要向 COM 註冊的組件。 |
AssemblyListFile |
選擇性 ITaskItem 參數。 包含有關 RegisterAssembly 工作和 UnregisterAssembly 工作之間狀態的資訊。這可以防止 UnregisterAssembly 工作試圖移除組件的註冊,這裡是指無法在 RegisterAssembly 工作中註冊的組件。 |
CreateCodeBase |
選擇性 (Optional) Boolean 參數。 如果為 true,則會在登錄中建立程式碼基底項目,以便對未安裝在全域組件快取中的組件指定檔案路徑。如果您將接著安裝要註冊到全域組件快取中的組件,就應該指定這個選項。 |
TypeLibFiles |
選擇性的 ITaskItem[] 輸出參數。 指定要從指定的組件中產生的型別程式庫。產生的型別程式庫含有在組件內定義之可存取型別的定義。只有在下列其中一項為 true 時,才會產生型別程式庫:
如果型別程式庫比傳入的組件還新,雖然不會產生新的型別程式庫,不過依然會註冊組件。 如果有指定此參數,則它的項目數目必須與 Assemblies 參數相同,否則工作便會失敗。如果沒有指定輸入,則工作會預設為組件的名稱,並將項目的副檔名變更為 .tlb。 |
範例
下列範例使用 RegisterAssembly 工作來註冊 MyAssemblies 項目集合所指定的組件。
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<MyAssemblies Include="MyAssembly.dll" />
<ItemGroup>
<Target Name="RegisterAssemblies">
<RegisterAssembly
Assemblies="@(MyAssemblies)" >
</Target>
</Project>