Sdílet prostřednictvím

Aximp.exe (importér ovládacích prvků ActiveX Windows Forms)

  • Článek

Importér ovládacích prvků ActiveX převede definice typů v knihovně typů modelu COM pro ovládací prvek ActiveX na ovládací prvek Windows Forms.

model Windows Forms může hostovat pouze model Windows Forms ovládací prvky – to znamená třídy odvozené z Control. Aximp.exe generuje obálkovou třídu pro ovládací prvek ActiveX, který může být hostován na Windows Forms. To umožňuje použít stejnou podporu návrhu a programovací metody jako pro ostatní ovládací prvky Windows Forms.

Chcete-li hostovat ovládací prvek ActiveX, je nutné vygenerovat obálkový ovládací prvek, který je odvozen od AxHost. Tento ovládací prvek obálky obsahuje instanci původního ovládacího prvku ActiveX. Dokáže komunikovat s ovládacím prvkem ActiveX, ale je zobrazen jako ovládací prvek Windows Forms. Tento vygenerovaný ovládací prvek hostuje ovládací prvek ActiveX a zpřístupňuje jeho vlastnosti, metody a události, jako by náležely vygenerovanému ovládacímu prvku.

Tento nástroj je automaticky nainstalován se sadou Visual Studio. Ke spuštění nástroje použijte Visual Studio Developer Command Prompt nebo Visual Studio Developer PowerShell.

Na příkazovém řádku zadejte následující:

Syntaxe

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

Poznámky

Argument Popis
soubor Název zdrojového souboru obsahujícího ovládací prvek ActiveX, který má být převeden. Argument souboru musí mít příponu .dll nebo .ocx.
Možnost Popis
/delaysign Určuje, že Aximp.exe podepíše výsledný ovládací prvek pomocí zpožděného podepisování. Tuto možnost je nutné zadat pomocí parametru /keycontainer:, /keyfile:nebo /publickey: parametru. Další informace o zpožděném procesu podepisování naleznete v tématu Zpoždění podepisování sestavení.
/help Zobrazí syntaxi příkazu a možnosti nástroje.
/keycontainer:containerName Podepíše výsledný ovládací prvek silným názvem pomocí dvojice veřejného/privátního klíče nalezeného v kontejneru klíčů určeném parametrem containerName.
/keyfile:jméno souboru Podepíše výsledný ovládací prvek silným názvem pomocí oficiální dvojice veřejného a privátního klíče vydavatele nalezeného v názvu souboru.
/nologo Potlačí zobrazení úvodního nápisu společnosti Microsoft.
/out:jméno souboru Určuje název sestavení, které se má vytvořit.
/publickey:jméno souboru Podepíše výsledný ovládací prvek silným názvem pomocí veřejného klíče nalezeného v souboru určeném názvem souboru.
/rcw:jméno souboru Používá určenou obálku volatelnou modulem runtime namísto generování nové. Můžete zadat více instancí. Aktuální adresář se používá pro relativní cesty. Další informace naleznete v tématu Runtime Callable Wrapper.
/silent Potlačí zobrazování zpráv o úspěšném dokončení.
/source Generuje zdrojový kód jazyka C# pro obálku Windows Forms.
/verbose Určuje režim podrobného vypisování; zobrazuje dodatečné informace o průběhu.
/? Zobrazí syntaxi příkazu a možnosti nástroje.

Aximp.exe najednou převede celé knihovny typů ovládacího prvku ActiveX a vytvoří sadu sestavení, která obsahují metadata Common Language Runtime (CML) a implementaci ovládacích prvků pro typy definované v původní knihovně typů. Generované soubory jsou pojmenovány podle následujícího vzoru:

Proxy modulu CLR (Common Language Runtime) pro typy modelu COM: progid.dll

model Windows Forms proxy pro ovládací prvky ActiveX (kde ax označuje ActiveX): Axprogid.dll

Poznámka:

Pokud název členu ovládacího prvku ActiveX odpovídá názvu definovanému v rozhraní .NET Framework, Aximp.exe při vytváření odvozené třídy AxHost před název člena přidá „Ctl“. Například, pokud ovládací prvek ActiveX má člen nazvaný „Layout“, přejmenuje se v odvozené třídě AxHost na „CtlLayout“, protože událost Layout je definována v rámci .NET Framework.

Tyto vygenerované soubory můžete prozkoumat pomocí nástrojů, jako jsou Ildasm.exe (IL Disassembler).

Použití Aximp.exe za účelem generování sestavení .NET pro ovládací prvek ActiveX pro webový prohlížeč (shdocvw.dll) není podporováno.

Při spuštění Aximp.exe přes shdocvw.dll se vždy vytvoří další soubor s názvem shdocvw.dll v adresáři, ze kterého je nástroj spuštěn. Pokud tento vygenerovaný soubor umístíte do adresáře Dokumenty, může to způsobit problémy v Průzkumníku Windows. Po restartování počítače systém Windows vyhledá v adresáři Documents před adresářem system32 kopii shdocvw.dll. Použije kopii, která najde v dokumentech, a pokusí se načíst spravované obálky. Průzkumník Windows nebude správně fungovat, protože spoléhá na vykreslovací modul ve verzi shdocvw.dll umístěné v adresáři system32. Pokud k tomuto problému dojde, odstraňte kopii shdocvw.dll v adresáři Dokumenty a restartujte počítač.

Příklad

Následující příkaz vygeneruje MediaPlayer.dll a AxMediaPlayer.dll pro ovládací prvek msdxm.ocxPřehrávač médií .

aximp c:\systemroot\system32\msdxm.ocx

Viz také