Aximp.exe (Pengimpor Kontrol Formulir Windows ActiveX)
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 otomatis terpasang dengan Visual Studio. Untuk menjalankan alat, gunakan Prompt Perintah Pengembang Visual Studio atau PowerShell Pengembang Visual Studio.
Pada perintah, masukkan 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: Filename |
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: Filename |
Menentukan nama rakitan yang akan dibuat. |
/publickey: Filename |
Menandatangani kontrol yang dihasilkan dengan nama yang kuat menggunakan kunci publik yang ditemukan dalam file yang ditentukan oleh filename. |
/rcw: Filename |
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, file tersebut dapat menyebabkan masalah bagi Windows Explorer. Ketika komputer di-boot ulang, Windows akan melihat direktori Dokumen sebelum direktori system32 menemukan salinan shdocvw.dll. Ini akan menggunakan salinan yang ditemukannya 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 boot ulang komputer.
Contoh
Perintah berikut menghasilkan MediaPlayer.dll dan AxMediaPlayer.dll untuk kontrol Media Player msdxm.ocx
.
aximp c:\systemroot\system32\msdxm.ocx
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk