共用方式為


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>

請參閱

概念

MSBuild 工作

其他資源

MSBuild 工作參考