Bagikan melalui

Tugas RegisterAssembly

  • Artikel

Membaca metadata dalam rakitan yang ditentukan dan menambahkan entri yang diperlukan ke registri, yang memungkinkan klien COM membuat kelas .NET Framework secara transparan. Perilaku tugas ini serupa, tetapi tidak identik, dengan Regasm.exe (alat Pendaftaran Rakitan).

Parameter

Tabel berikut ini menjelaskan parameter tugas RegisterAssembly.

Parameter Deskripsi
Assemblies Parameter ITaskItem[] wajib.

Menentukan rakitan yang akan didaftarkan dengan COM.
AssemblyListFile Parameter ITaskItem opsional.

Berisi informasi tentang status antara RegisterAssembly tugas dan tugas UnregisterAssembly. Informasi ini mencegah UnregisterAssembly tugas dari mencoba membatalkan pendaftaran rakitan yang gagal mendaftar dalam tugas RegisterAssembly.
CreateCodeBase Parameter Boolean opsional.

Jika true, membuat entri basis kode di registri, yang menentukan jalur file untuk rakitan yang tidak diinstal di cache perakitan global. Anda tidak boleh menentukan opsi ini jika Anda kemudian akan menginstal rakitan yang Anda daftarkan ke cache rakitan global.
TypeLibFiles Parameter output ITaskItem[] opsional.

Menentukan pustaka jenis yang akan dihasilkan dari rakitan yang ditentukan. Pustaka jenis yang dihasilkan berisi definisi jenis yang dapat diakses yang ditentukan dalam rakitan. Pustaka jenis hanya dihasilkan jika salah satu kondisi berikut ini benar:

- Pustaka jenis nama itu tidak ada di lokasi tersebut.
- Pustaka jenis ada tetapi lebih tua dari rakitan yang diteruskan.

Jika pustaka jenis lebih baru dari rakitan yang diteruskan, pustaka baru tidak akan dibuat, tetapi rakitan masih akan didaftarkan.

Jika parameter ini ditentukan, parameter harus memiliki jumlah item Assemblies yang sama dengan parameter atau tugas akan gagal. Jika tidak ada input yang ditentukan, tugas akan default ke nama rakitan dan mengubah ekstensi item menjadi .tlb.

Keterangan

Selain parameter yang tercantum di atas, tugas ini mewarisi parameter dari kelas TaskExtension, yang mewarisi sendiri dari kelas Task. Untuk daftar parameter tambahan ini dan deskripsinya, lihat kelas dasar TaskExtension.

Contoh

Contoh berikut menggunakan RegisterAssembly tugas untuk mendaftarkan rakitan yang ditentukan oleh MyAssemblies kumpulan item.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <MyAssemblies Include="MyAssembly.dll" />
    <ItemGroup>

    <Target Name="RegisterAssemblies">
        <RegisterAssembly
            Assemblies="@(MyAssemblies)" >
    </Target>

</Project>

Baca juga