Cara membuat pembungkus COM

Catatan

Panduan ini khusus untuk .NET Framework. Untuk interop COM .NET modern, gunakan interop COM yang dibuat dari sumber atau API System.Runtime.InteropServices.ComWrappers. Untuk informasi selengkapnya, lihat Gambaran umum interop COM dan pembuatan sumber COM.

Anda dapat membuat pembungkus Component Object Model (COM) menggunakan fitur Visual Studio atau alat .NET Framework Tlbimp.exe dan Regasm.exe. Kedua metode menghasilkan dua jenis pembungkus COM:

Di Visual Studio, Anda dapat menambahkan pembungkus COM sebagai referensi ke proyek Anda.

Membungkus objek COM dalam aplikasi terkelola

Membuat runtime callable wrapper dengan Visual Studio

  1. Buka proyek untuk aplikasi terkelola Anda.

  2. Pada menu Proyek, klik Tampilkan Semua File.

  3. Pada menu Proyek, klik Tambahkan Referensi.

  4. Di kotak dialog Tambahkan Referensi, klik tab COM, pilih komponen yang ingin Anda gunakan, dan klik OK.

    Di Penjelajah Solusi, perhatikan bahwa komponen COM ditambahkan ke folder Referensi di proyek Anda.

Anda sekarang dapat menulis kode untuk mengakses objek COM. Anda dapat memulai dengan mendeklarasikan objek, seperti dengan Imports pernyataan untuk Visual Basic atau Using arahan untuk C#.

Catatan

Jika Anda ingin memprogram komponen Microsoft Office, instal terlebih dahulu Microsoft Office Primary Interop Assemblies Redistributable.

Untuk membuat runtime callable wrapper (RCW) menggunakan alat .NET Framework

Alat ini membuat rakitan yang berisi metadata runtime untuk jenis yang ditentukan dalam perpustakaan jenis asli.

Membungkus objek terkelola dalam aplikasi asli

Untuk membuat pembungkus COM yang dapat dipanggil menggunakan Visual Studio

  1. Buat proyek Pustaka Kelas untuk kelas terkelola yang ingin Anda jalankan dalam kode native. Kelas harus memiliki konstruktor tanpa parameter.

    Pastikan nomor versi lengkap yang terdiri dari empat bagian untuk assembly Anda tercantum di file AssemblyInfo. Nomor ini diperlukan untuk mempertahankan versi di registri Windows. Untuk informasi selengkapnya tentang nomor versi, lihat Pembuatan Versi Assembly.

  2. Pada menu Proyek, klik Properti.

  3. Klik tab Kompilasi.

  4. Centang kotak centang Daftarkan untuk interoperabilitas COM.

Saat Anda mengompilasi proyek, assembly secara otomatis didaftarkan untuk COM interop. Jika Anda sedang membangun aplikasi asli di Visual Studio, Anda dapat menggunakan rakitan dengan mengeklik Tambahkan Referensi pada menu Proyek.

Untuk membuat pembungkus COM yang dapat dipanggil menggunakan alat .NET Framework

Jalankan alat Regasm.exe (Alat Pendaftaran Perakitan).

Alat ini membaca metadata rakitan dan menambahkan entri yang diperlukan ke registri. Hasilnya, klien COM dapat membuat kelas .NET Framework secara transparan. Anda dapat menggunakan assembly seolah-olah itu merupakan kelas COM asli.

Anda dapat menjalankan Regasm.exe pada rakitan yang terletak di direktori mana pun, lalu jalankan Gacutil.exe (Alat Cache Perakitan Global) untuk memindahkannya ke cache perakitan global. Memindahkan rakitan tidak membatalkan entri registri lokasi, karena cache rakitan global selalu diperiksa jika rakitan tidak ditemukan di tempat lain.

Lihat juga

  • Last updated on