Aximp.exe (Importer kontrolki ActiveX formularzy systemu Windows)

  • Artykuł

Importer formantów ActiveX konwertuje definicje typów w bibliotece typów modelu COM dla formantu ActiveX na formant programu Windows Forms.

Windows Forms może hostować tylko kontrolki Windows Forms — czyli klasy pochodzące z Controlklasy . Program Aximp.exe generuje klasę otoki dla formantu ActiveX, którą można obsługiwać w programie Windows Form. Dzięki temu można korzystać z metodologii obsługi w czasie projektowania i programowania, która jest stosowana do innych formantów programu Windows Forms.

Aby hostować kontrolkę ActiveX, należy wygenerować kontrolkę otoki, która pochodzi z AxHostklasy . Ten formant otoki zawiera wystąpienie źródłowego formantu ActiveX. Umożliwia on komunikację z formantem ActiveX, ale jest widoczny jako formant programu Windows Forms. Ten wygenerowany formant obsługuje formant ActiveX i uwidacznia jego właściwości, metody i zdarzenia, tak jakby należały do wygenerowanego formantu.

To narzędzie jest instalowane automatycznie z programem Visual Studio. Aby uruchomić narzędzie, użyj wiersza polecenia dla deweloperów programu Visual Studio lub programu Visual Studio Developer PowerShell.

W wierszu polecenia wpisz następujące polecenie:

Składnia

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

Uwagi

Argument Opis
Plik Nazwa pliku źródłowego, który zawiera formant ActiveX do przekonwertowania. Argument file musi mieć rozszerzenie dll lub ocx.
Opcja Opis
/delaysign Określa, że program Aximp.exe ma podpisać wynikowy formant, używając funkcji podpisywania opóźnionego. Tę opcję należy określić za pomocą /keycontainer:opcji , /keyfile:lub /publickey: . Aby uzyskać więcej informacji na temat opóźnionego procesu podpisywania, zobacz Opóźnianie podpisywania zestawu.
/help Wyświetla składnię polecenia i opcje narzędzia.
/keycontainer:containerName Podpisuje wynikową kontrolkę o silnej nazwie przy użyciu pary kluczy publicznych/prywatnych znalezionych w kontenerze kluczy określonym przez containerName.
/keyfile:Pod nazwą Podpisuje wynikową kontrolkę o silnej nazwie przy użyciu oficjalnej pary kluczy publicznych/prywatnych wydawcy znalezionej w nazwie pliku.
/nologo Pomija wyświetlanie transparentu startowego firmy Microsoft.
/out:Pod nazwą Określa nazwę zestawu, który ma zostać utworzony.
/publickey:Pod nazwą Podpisuje wynikową kontrolkę o silnej nazwie przy użyciu klucza publicznego znalezionego w pliku określonym przez nazwę pliku.
/rcw:Pod nazwą Używa określonej wywoływalnej otoki czasu wykonywania, zamiast generować nową. Można określić wiele wystąpień. Dla ścieżek względnych jest używany bieżący katalog. Aby uzyskać więcej informacji, zobacz Runtime Callable Wrapper (Zawijane wywołanie środowiska uruchomieniowego).
/silent Pomija wyświetlanie komunikatów o sukcesie.
/source Generuje kod źródłowy w języku C# dla otoki programu Windows Forms.
/verbose Określa tryb pełny; wyświetla dodatkowe informacje o postępie.
/? Wyświetla składnię polecenia i opcje narzędzia.

Program Aximp.exe konwertuje całą bibliotekę typów formantu ActiveX jednocześnie i tworzy zbiór zestawów zawierający metadane środowiska uruchomieniowego języka wspólnego oraz implementację formantu dla typów zdefiniowanych w oryginalnej bibliotece typów. Nazwy wygenerowanych plików są określane według następującego wzorca:

Serwer proxy środowiska uruchomieniowego języka wspólnego dla typów COM: progid.dll

serwer proxy Windows Forms dla kontrolek ActiveX (gdzie ax oznacza ActiveX):progid osi.dll

Uwaga

Jeśli nazwa składowej formantu ActiveX pasuje do nazwy zdefiniowanej w programie .NET Framework, program Aximp.exe poprzedzi nazwę składowej prefiksem „Ctl”, gdy będzie tworzyć klasę pochodną AxHost. Na przykład jeśli formant ActiveX ma składową o nazwie Layout, jej nazwa w klasie pochodnej AxHost zostanie zmieniona na CtlLayout, ponieważ zdarzenie Layout jest zdefiniowane w programie .NET Framework.

Możesz zbadać te wygenerowane pliki za pomocą narzędzi, takich jak Ildasm.exe (IL Dezasembler).

Nie można używać programu Aximp.exe do generowania zestawu platformy .NET dla formantu ActiveX WebBrowser.

Po uruchomieniu programu Aximp.exe dla biblioteki shdocvw.dll zawsze jest tworzony inny plik o nazwie shdocvw.dll w katalogu, z którego uruchomiono narzędzie. Jeśli ten wygenerowany plik zostanie umieszczany w katalogu Documents, może to spowodować problemy z Eksploratorem Windows. Po ponownym uruchomieniu komputera system Windows znajduje się w katalogu Documents przed katalogiem system32, aby znaleźć kopię shdocvw.dll. Użyje kopii znalezionej w dokumentach i spróbuje załadować zarządzane otoki. Eksplorator Windows nie będzie działać prawidłowo, ponieważ korzysta z aparatu renderowania w wersji shdocvw.dll znajdującej się w katalogu system32. Jeśli ten problem wystąpi, usuń kopię shdocvw.dll w katalogu Documents i uruchom ponownie komputer.

Przykład

Następujące polecenie generuje MediaPlayer.dll i AxMediaPlayer.dll dla kontrolki msdxm.ocxMedia Player .

aximp c:\systemroot\system32\msdxm.ocx

Zobacz też