RegisterAssembly 工作

發行項
06/09/2015

讀取指定組件內的中繼資料，並將必要項目加入到可讓 COM 用戶端以透明方式建立 .NET Framework類別的登錄中。此工作的行為類似於 (但不完全相同) Regasm.exe (組件登錄工具) 的行為。

參數

下表說明 RegisterAssembly 工作的參數。

參數	描述
Assemblies	必要的 ITaskItem[] 參數。指定要向 COM 註冊的組件。
AssemblyListFile	選擇性 ITaskItem 參數。包含有關 RegisterAssembly 工作和 UnregisterAssembly 工作之間狀態的資訊。這可以防止 UnregisterAssembly 工作試圖針對無法在 RegisterAssembly 工作中註冊的組件移除註冊。
CreateCodeBase	選擇性 Boolean 參數。如果為 true，則會在登錄中建立程式碼基底項目，以便對未安裝在全域組件快取中的組件指定檔案路徑。如果您將接著安裝要註冊到全域組件快取中的組件，就應該指定這個選項。
TypeLibFiles	選擇性的 ITaskItem[] 輸出參數。指定要從指定的組件中產生的型別程式庫。產生的型別程式庫含有在組件內定義之可存取型別的定義。只有在下列其中一項為 true 時，才會產生型別程式庫：該位置上沒有該名稱的型別程式庫。雖然有型別程式庫，但是比傳入的組件還舊。如果型別程式庫比傳入的組件還新，雖然不會產生新的型別程式庫，不過依然會註冊組件。如果有指定此參數，則它的項目數目必須與 Assemblies 參數相同，否則工作便會失敗。如果沒有指定輸入，則工作會預設為組件的名稱，並將項目的副檔名變更為 .tlb。

備註

除了以上列出的參數之外，此項工作還會繼承 TaskExtension 類別中的參數，而該類別本身又繼承 Task 類別。如需這些錯誤碼的清單及其說明，請參閱 TaskExtension 基底類別。

範例

下列範例使用 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>

共用方式為

RegisterAssembly 工作

參數

備註

範例

請參閱

概念

其他資源

其他資源