Bagikan melalui

Tugas UnregisterAssembly

  • Artikel

Membatalkan pendaftaran rakitan yang ditentukan untuk tujuan interop COM. Melakukan pembalikan tugas RegisterAssembly.

Parameter

Tabel berikut ini menjelaskan parameter tugas UnregisterAssembly.

Parameter Deskripsi
Assemblies Parameter ITaskItem[] opsional.

Menentukan rakitan yang akan dibatalkan pendaftarannya.
AssemblyListFile Parameter ITaskItem opsional.

Berisi informasi tentang status antara tugas RegisterAssembly dan tugas UnregisterAssembly. Ini mencegah tugas mencoba membatalkan pendaftaran rakitan yang gagal mendaftar dalam tugas RegisterAssembly.

Jika parameter ini ditentukan, parameter Assemblies dan TypeLibFiles diabaikan.
TypeLibFiles Parameter output ITaskItem[] opsional.

Membatalkan pendaftaran pustaka jenis yang ditentukan dari rakitan yang ditentukan. Catatan: Parameter ini hanya diperlukan jika nama file pustaka jenis berbeda dari nama rakitan.

Keterangan

Tidak diperlukan adanya rakitan agar tugas ini berhasil. Jika Anda mencoba membatalkan pendaftaran rakitan yang tidak ada, tugas akan berhasil dengan peringatan. Ini terjadi karena tugas ini adalah tugas untuk menghapus pendaftaran perakitan dari registri. Jika rakitan tidak ada, ini tidak ada di registri, dan oleh karena itu, tugas berhasil.

Selain parameter yang tercantum di atas, tugas ini mewarisi parameter dari kelas AppDomainIsolatedTaskExtension, yang mewarisi sendiri dari kelas MarshalByRefObject. Kelas MarshalByRefObject menyediakan fungsionalitas yang sama dengan kelas Task, tetapi dapat dibuat di domain aplikasinya sendiri.

Contoh

Contoh berikut menggunakan tugas UnregisterAssembly untuk membatalkan pendaftaran rakitan di jalur yang ditentukan oleh properti OutputPath dan FileName, jika ada.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <PropertyGroup>
        <OutputPath>\Output\</OutputPath>
        <FileName>MyFile.dll</FileName>
    </PropertyGroup>
    <Target Name="UnregisterAssemblies">
        <UnregisterAssembly
            Condition="Exists('$(OutputPath)$(FileName)')"
            Assemblies="$(OutputPath)$(FileName)" />
    </Target>

</Project>

Baca juga