Bagikan melalui

Aximp.exe (Pengimpor Kontrol ActiveX Formulir Windows)

  • Artikel

Importir Kontrol ActiveX mengonversi definisi jenis di pustaka jenis COM untuk kontrol ActiveX menjadi kontrol Formulir Windows.

Formulir Windows hanya dapat menghosting kontrol Formulir Windows—yaitu, kelas yang diturunkan dari Control. Aximp.exe menghasilkan kelas pembungkus untuk kontrol ActiveX yang dapat di-host di Formulir Windows. Ini memungkinkan Anda untuk menggunakan dukungan waktu desain dan metodologi pemrograman yang sama yang berlaku untuk kontrol Formulir Windows lainnya.

Untuk menghosting kontrol ActiveX, Anda harus membuat kontrol pembungkus yang berasal dari AxHost. Kontrol pembungkus ini berisi turunan dari kontrol ActiveX yang mendasarinya. Kontrol tersebut tahu cara berkomunikasi dengan kontrol ActiveX, tetapi muncul sebagai kontrol Formulir Windows. Kontrol yang dihasilkan ini menghosting kontrol ActiveX dan mengekspos properti, metode, dan kejadiannya sebagai kontrol yang dihasilkan.

Alat ini secara otomatis diinstal dengan Visual Studio. Untuk menjalankan alat, gunakan Prompt Perintah Pengembang Visual Studio atau PowerShell Pengembang Visual Studio .

Pada prompt perintah, ketik berikut ini:

Sintaks

aximp [options]{file.dll | file.ocx}

Keterangan

Argumen Deskripsi
file Nama file sumber yang berisi kontrol ActiveX untuk dikonversi. Argumen file harus memiliki ekstensi .dll atau .ocx.
Opsi Deskripsi
/delaysign Menentukan untuk Aximp.exe untuk menandatangani kontrol yang dihasilkan menggunakan penandatanganan tertunda. Anda harus menentukan opsi ini dengan opsi /keycontainer:, /keyfile:, atau /publickey:. Untuk informasi selengkapnya tentang proses penandatanganan yang tertunda, baca Menunda Penandatanganan Rakitan.
/help Menampilkan sintaks perintah dan opsi untuk alat ini.
/keycontainer:containerName Menandatangani kontrol yang dihasilkan dengan nama yang kuat menggunakan pasangan kunci publik/pribadi yang ditemukan di penampung kunci yang ditentukan oleh containerName.
/keyfile:nama file Menandatangani kontrol yang dihasilkan dengan nama yang kuat menggunakan pasangan kunci publik/pribadi resmi penerbit yang ditemukan di filename.
/nologo Menekan tampilan banner startup Microsoft.
/out:nama file Menentukan nama rakitan yang akan dibuat.
/publickey:nama file Menandatangani kontrol yang dihasilkan dengan nama yang kuat menggunakan kunci publik yang ditemukan dalam file yang ditentukan oleh filename.
/rcw:nama file Menggunakan pembungkus yang dapat dipanggil runtime yang ditentukan daripada membuat yang baru. Anda dapat menentukan beberapa instans. Direktori saat ini digunakan untuk jalur relatif. Untuk informasi selengkapnya, baca Pembungkus yang Dapat Dipanggil Runtime.
/silent Menekan tampilan pesan sukses.
/source Menghasilkan kode sumber C# untuk pembungkus Formulir Windows.
/verbose Menentukan mode verbose; menampilkan informasi kemajuan tambahan.
/? Menampilkan sintaks perintah dan opsi untuk alat ini.

Aximp.exe mengonversi seluruh pustaka jenis Kontrol ActiveX sekaligus dan menghasilkan kumpulan rakitan yang berisi metadata runtime bahasa umum dan implementasi kontrol untuk jenis yang ditentukan di pustaka jenis asli. File yang dihasilkan diberi nama sesuai dengan pola berikut:

Proksi runtime bahasa umum untuk jenis COM: progid.dll

Proksi Formulir Windows untuk kontrol ActiveX (ketika Ax menandakan ActiveX): Axprogid.dll

Catatan

Jika nama anggota kontrol ActiveX cocok dengan nama yang ditentukan dalam .NET Framework, Aximp.exe akan mengawali nama anggota dengan "Ctl" saat membuat kelas turunan AxHost. Misalnya, jika kontrol ActiveX Anda memiliki anggota bernama "Layout", maka akan diganti namanya menjadi "CtlLayout" di kelas turunan AxHost karena peristiwa Tata Letak ditentukan dalam .NET Framework.

Anda dapat memeriksa file yang dihasilkan ini dengan alat seperti Ildasm.exe (IL Disassembler).

Menggunakan Aximp.exe untuk menghasilkan rakitan .NET untuk kontrol ActiveX WebBrowser (shdocvw.dll) tidak didukung.

Saat Anda menjalankan Aximp.exe melalui shdocvw.dll, cara itu akan selalu membuat file lain bernama shdocvw.dll di direktori tempat alat dijalankan. Jika Anda menempatkan file yang dihasilkan ini di direktori Dokumen, itu dapat menyebabkan masalah bagi Windows Explorer. Ketika komputer di-boot ulang, Windows melihat direktori Dokumen sebelum direktori system32 menemukan salinan shdocvw.dll. Ini akan menggunakan salinan yang ditemukan di Dokumen dan mencoba memuat pembungkus terkelola. Windows Explorer tidak akan berfungsi dengan baik karena bergantung pada mesin penyajian dalam versi shdocvw.dll yang terletak di direktori system32. Jika masalah ini terjadi, hapus salinan shdocvw.dll di direktori Dokumen dan reboot komputer.

Contoh

Perintah berikut menghasilkan MediaPlayer.dll dan AxMediaPlayer.dll untuk kontrol Media Player msdxm.ocx.

aximp c:\systemroot\system32\msdxm.ocx

Lihat juga