Aximp.exe (Windows Forms ActiveX Control Importer)
Az ActiveX-vezérlőimportőr egy COM-típusú kódtárban lévő típusdefiníciókat konvertál egy ActiveX-vezérlőhöz Windows Forms-vezérlővé.
A Windows Forms csak Windows Forms-vezérlőket képes üzemeltetni, vagyis azokat az osztályokat, amelyekből Controlszármazik. Aximp.exe létrehoz egy burkolóosztályt egy Windows-űrlapon üzemeltethető ActiveX-vezérlőhöz. Ez lehetővé teszi, hogy ugyanazt a tervezési idejű támogatási és programozási módszertant használja, amely más Windows Forms-vezérlőkre is alkalmazható.
Az ActiveX-vezérlő üzemeltetéséhez létre kell hoznia egy burkolóvezérlőt, amely a következőből AxHostszármazik: . Ez a burkoló vezérlőelem a mögöttes ActiveX-vezérlő egy példányát tartalmazza. Tudja, hogyan kommunikálhat az ActiveX-vezérlővel, de Windows Forms-vezérlőként jelenik meg. Ez a létrehozott vezérlő üzemelteti az ActiveX-vezérlőt, és a létrehozott vezérlő tulajdonságai, metódusai és eseményei elérhetővé teszik őket.
Ez az eszköz automatikusan telepítve van a Visual Studióval. Az eszköz futtatásához használja a Visual Studio fejlesztői parancssorát vagy a Visual Studio Developer PowerShellt.
A parancssorba írja be a következőt:
Syntax
aximp [options]{file.dll | file.ocx}
Megjegyzések
Argumentum | Leírás |
---|---|
fájl | A konvertálni kívánt ActiveX-vezérlőt tartalmazó forrásfájl neve. A fájlargumentumnak .dll vagy .ocx kiterjesztéssel kell rendelkeznie. |
Lehetőség | Leírás |
---|---|
/delaysign |
Megadja, hogy Aximp.exe az eredményként kapott vezérlőt késleltetett aláírással írja alá. Ezt a beállítást a , /keyfile: vagy /publickey: a /keycontainer: beállítással kell megadnia. A késleltetett aláírási folyamatról további információt a szerelvény aláírásának késleltetése című témakörben talál. |
/help |
Megjeleníti az eszköz parancsszintaxisát és beállításait. |
/keycontainer: containerName |
Az eredményként kapott vezérlőt erős névvel írja alá a containerName által megadott kulcstárolóban található nyilvános/titkos kulcspár használatával. |
/keyfile: fájlnév |
Az eredményként kapott vezérlőt erős névvel írja alá a közzétevő hivatalos nyilvános/titkos kulcspárjával, amely a fájlnévben található. |
/nologo |
Letiltja a Microsoft indítási szalagcímének megjelenítését. |
/out: fájlnév |
Megadja a létrehozni kívánt szerelvény nevét. |
/publickey: fájlnév |
Az eredményként kapott vezérlőt erős névvel írja alá a fájlnév által megadott fájlban található nyilvános kulccsal. |
/rcw: fájlnév |
A megadott futtatókörnyezeti hívható burkolót használja új helyett. Több példányt is megadhat. A rendszer az aktuális könyvtárat használja a relatív elérési utakhoz. További információ: Runtime Callable Burkoló. |
/silent |
Letiltja a sikeres üzenetek megjelenítését. |
/source |
C# forráskódot hoz létre a Windows Forms burkolóhoz. |
/verbose |
Részletes módot ad meg; további állapotinformációkat jelenít meg. |
/? |
Megjeleníti az eszköz parancsszintaxisát és beállításait. |
Aximp.exe egyszerre egy teljes ActiveX-vezérlő típusú kódtárat konvertál, és olyan szerelvényeket hoz létre, amelyek tartalmazzák a közös nyelvi futtatókörnyezet metaadatait és az eredeti típustárban definiált típusok vezérlési implementációját. A létrehozott fájlok neve a következő minta szerint van elnevezve:
Com-típusok közös nyelvi futtatókörnyezeti proxyja: progid.dll
Windows Forms-proxy ActiveX-vezérlőkhöz (ahol az Ax az ActiveX-et jelöli): Axprogid.dll
Feljegyzés
Ha az ActiveX-vezérlő egy tagjának neve megegyezik a .NET-keretrendszer definiált névvel, Aximp.exe az AxHost származtatott osztály létrehozásakor a tag nevét "Ctl" előtaggal nyitja meg. Ha például az ActiveX-vezérlő "Layout" nevű tagot használ, a rendszer átnevezi a "CtlLayout" nevet az AxHost származtatott osztályban, mert az Elrendezés esemény a .NET-keretrendszer belül van definiálva.
Ezeket a létrehozott fájlokat olyan eszközökkel vizsgálhatja meg, mint például a Ildasm.exe (IL Disassembler).
Az ActiveX WebBrowser vezérlőhöz (shdocvw.dll) nem használható .NET-szerelvény létrehozása Aximp.exe használatával.
Ha Aximp.exe futtat shdocvw.dll, az mindig létrehoz egy shdocvw.dll nevű fájlt abban a könyvtárban, amelyből az eszköz fut. Ha a létrehozott fájlt a Dokumentumok könyvtárba helyezi, az problémákat okozhat a Windows Intézőben. A számítógép újraindítása után a Windows a Dokumentumok könyvtárban a system32 könyvtár előtt keresi meg a shdocvw.dll egy példányát. A dokumentumokban talált másolatot fogja használni, és megpróbálja betölteni a felügyelt burkolókat. A Windows Intéző nem fog megfelelően működni, mert a rendszer32 könyvtárban található shdocvw.dll verziójában a renderelő motorra támaszkodik. Ha ez a probléma jelentkezik, törölje a shdocvw.dll másolatát a Dokumentumok könyvtárban, és indítsa újra a számítógépet.
Példa
Az alábbi parancs MediaPlayer.dll és AxMediaPlayer.dll hoz létre a Médialejátszó vezérlőelemhezmsdxm.ocx
.
aximp c:\systemroot\system32\msdxm.ocx