Utilità di importazione di controlli ActiveX di Windows Form (Aximp.exe)
L'utilità di importazione di controlli ActiveX converte in un controllo Windows Form le definizioni dei tipi in una libreria di tipi COM per un controllo ActiveX.
I Windows Form possono contenere solo controlli Windows Form, ovvero classi derivate da Control. Per ogni controllo ActiveX, in Aximp.exe viene generata una classe wrapper che è possibile inserire in un Windows Form. Questo consente di utilizzare lo stesso supporto per la fase di progettazione e la stessa metodologia di programmazione applicabili ad altri controlli Windows Form.
Per inserire il controllo ActiveX, è necessario generare un controllo wrapper che derivi da AxHost. Tale controllo contiene un'istanza del controllo ActiveX sottostante ed è in grado di comunicare con il controllo ActiveX pur avendo l'aspetto di un controllo Windows Form. Il controllo così generato contiene il controllo ActiveX e ne espone proprietà, metodi ed eventi come se fossero del controllo generato.
aximp [options]{file.dll | file.ocx}
Note
| Argomento | Descrizione |
|---|---|
file |
Il nome del file di origine contenente il controllo ActiveX da convertire. L'argomento del file deve avere un'estensione DLL oppure OCX. |
| Opzione | Descrizione |
|---|---|
/delaysign |
Specifica ad Aximp.exe di firmare il controllo risultante utilizzando la firma posticipata. È necessario specificare questa opzione con /keycontainer:, /keyfile: o /publickey:. Per ulteriori informazioni sul processo di firma posticipata, vedere Ritardo della firma di un assembly. |
/help |
Visualizza la sintassi e le opzioni dei comandi dello strumento. |
/keycontainer: containerName |
Firma il controllo risultante con un nome sicuro utilizzando la coppia di chiavi pubblica/privata presente nel contenitore delle chiavi specificato da containerName. |
/keyfile: filename |
Firma il controllo risultante con un nome sicuro, utilizzando la coppia di chiavi ufficiali pubblica/privata dell'editore presente in filename. |
/nologo |
Evita la visualizzazione del messaggio di avvio Microsoft. |
/out: filename |
Specifica il nome dell'assembly da creare. |
/publickey: filename |
Firma il controllo risultante con un nome sicuro utilizzando la chiave pubblica presente nel file specificato da filename. |
/silent |
Evita la visualizzazione dei messaggi di operazione riuscita. |
/source |
Genera codice sorgente di C# per il wrapper di Windows Form. |
/verbose |
Specifica la modalità dettagliata. Visualizza ulteriori informazioni sullo stato. |
/? |
Visualizza la sintassi e le opzioni dei comandi dello strumento. |
Aximp.exe converte un'intera libreria dei tipi di controlli ActiveX alla volta e produce un insieme di assembly contenenti i metadati di Common Language Runtime e l'implementazione del controllo per i tipi definiti nella libreria dei tipi originale. I file generati vengono denominati in base ai seguenti criteri:
Proxy di Common Language Runtime per i tipi COM: progid.dll
Proxy di Windows Form per i controlli ActiveX (dove Ax significa ActiveX): Axprogid.dll
Nota
Se il nome di un membro del controllo ActiveX corrisponde a un nome definito in .NET Framework, il nome del membro verrà fatto precedere dal prefisso "Ctl" durante la creazione della classe derivata da AxHost. Se, ad esempio, il controllo ActiveX contiene un membro denominato "Layout", questo verrà rinominato "CtlLayout" nella classe derivata da AxHost in quanto l'evento Layout viene definito all'interno di .NET Framework.
È possibile esaminare i file generati con strumenti quali Disassembler MSIL (Ildasm.exe).
L'esecuzione di Aximp.exe sul file shdocvw.dll del controllo ActiveX comporterà sempre la creazione di un altro file denominato shdocvw.dll nella directory da cui viene eseguito lo strumento. L'inserimento nella directory Documents and Settings del file generato causerà problemi per Microsoft Internet Explorer ed Esplora risorse. Al riavvio del computer, viene eseguita una ricerca nella directory Documents and Settings prima che nella directory system32 per trovare una copia di shdocvw.dll. Verrà utilizzata la copia trovata in Documents and Settings e verrà effettuato un tentativo di caricamento dei wrapper gestiti. Internet Explorer ed Esplora risorse non funzioneranno correttamente in quanto dipendono dal motore di rendering della versione di shdocvw.dll presente nella directory system32. Se si verifica tale problema, eliminare la copia di shdocvw.dll nella directory Documenti e impostazioni e riavviare il computer.
Esempio
Il comando riportato di seguito consente la generazione di MediaPlayer.dll e di AxMediaPlayer.dll per il controllo msdxm.ocx di Media Player.
aximp c:\systemroot\system32\msdxm.ocx