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, musíte vygenerovat ovládací prvek obálky, který je odvozen z 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.

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

Syntax

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

Poznámky

Argument Description
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í /keycontainer:možnosti , /keyfile:nebo /publickey: . Další informace o zpožděném procesu podepisování naleznete v tématu Zpoždění podepsání sestavení.
/help Zobrazí syntaxi příkazu a možnosti nástroje.
/keycontainer:název_kontejneru Podepíše výsledný ovládací prvek silným názvem pomocí páru veřejného a privátního klíče, který se nachází v kontejneru klíčů určeném parametrem containerName.
/keyfile:Název_souboru Podepíše výsledný ovládací prvek silným názvem pomocí oficiálního páru veřejného a privátního klíče vydavatele, který se nachází v názvu souboru.
/nologo Potlačí zobrazení úvodního nápisu společnosti Microsoft.
/out:Název_souboru Určuje název sestavení, které se má vytvořit.
/publickey:Název_souboru Podepíše výsledný ovládací prvek silným názvem pomocí veřejného klíče, který najdete v souboru určeném názvem souboru.
/rcw:Název_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 najdete v tématu Obálka volatelná za běhu.
/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 modul runtime společného jazyka 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 je 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íkovi Windows. Po restartování počítače systém Windows vyhledá v adresáři Dokumenty 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 fungovat správně, protože spoléhá na vykreslovací modul ve verzi shdocvw.dll umístěné v adresáři system32. Pokud dojde k tomuto problému, odstraňte kopii shdocvw.dll v adresáři Documents a restartujte počítač.

Příklad

Následující příkaz vygeneruje MediaPlayer.dll a AxMediaPlayer.dll pro ovládací prvek msdxm.ocxMedia Player .

aximp c:\systemroot\system32\msdxm.ocx

Viz také