Importador de controles ActiveX de formularios Windows Forms (Aximp.exe)

El Importador de controles ActiveX convierte definiciones de tipos de una biblioteca de tipos COM para un control ActiveX en un control de formularios Windows Forms.

Los formularios Windows Forms sólo pueden alojar controles de formularios Windows Forms; es decir, clases derivadas de Control. Aximp.exe genera una clase contenedora para un control ActiveX que se puede alojar en un formulario Windows Forms. Esto permite utilizar la misma funcionalidad para diseño y la misma metodología de programación que si se tratase de controles usuales de formularios Windows Forms.

Para alojar el control ActiveX, debe generar un control contendor que se derive de AxHost. Este control contenedor contiene una instancia del control ActiveX subyacente. También sabe cómo establecer comunicación con el control ActiveX, pero aparece como un control de formularios Windows Forms. Este control generado contiene el control ActiveX y proporciona sus propiedades, métodos y eventos como si fuesen propios.

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

Comentarios

Argumento	Descripción
file	Nombre del archivo de código fuente que contiene el control ActiveX que se convierte. Este argumento debe tener la extensión .ocx o .dll.

Opción	Descripción
/delaysign	Especifica que Aximp.exe debe firmar el control resultante mediante firma postergada. Esta opción se debe especificar con la opción /keycontainer:, /keyfile: o la opción /publickey:. Para obtener más información sobre el proceso de firmas postergado, vea Retrasar la firma de un ensamblado.
/help	Muestra la sintaxis de comandos y opciones para la herramienta.
/keycontainer: containerName	Firma el control resultante con un nombre seguro mediante el par de clave pública y clave privada del contenedor de claves especificado por containerName.
/keyfile: filename	Firma el control resultante con un nombre seguro utilizando el par de clave pública y clave privada oficial del editor que se encuentra en filename.
/nologo	Suprime la presentación de la portada de inicio de Microsoft.
/out: filename	Especifica el nombre del ensamblado que se va a crear.
/publickey: filename	Firma el control resultante con un nombre seguro mediante la clave pública del archivo especificado por filename.
/silent	Suprime la presentación de mensajes de aprobación.
/source	Genera código fuente C# para el contenedor de formularios Windows Forms.
/verbose	Especifica el modo detallado; muestra información adicional del progreso.
/?	Muestra la sintaxis de comandos y opciones para la herramienta.

Aximp.exe convierte una biblioteca de tipos completa de controles ActiveX de una vez y produce un conjunto de ensamblados que contienen los metadatos de Common Language Runtime y la implementación de controles para los tipos definidos en la biblioteca de tipos original. Los archivos generados se denominan de acuerdo con el siguiente modelo:

Proxy de Common Language Runtime para tipos COM: progid.dll

Proxy de formularios Windows Forms para controles ActiveX (donde Ax significa ActiveX): Axprogid.dll

Nota

Si el nombre de un miembro del control ActiveX coincide con un nombre definido en .NET Framework, Aximp.exe agregará el prefijo "Ctl" al nombre del miembro al crear la clase derivada AxHost. Por ejemplo, si el control ActiveX tiene un miembro denominado "Layout", el nombre de éste se cambia a "CtlLayout" en la clase derivada AxHost porque el evento Layout está definido en .NET Framework.

Puede examinar estos archivos generados con herramientas como Desensamblador de MSIL (Ildasm.exe).

Al ejecutar Aximp.exe sobre el control ActiveX shdocvw.dll, siempre se creará otro archivo denominado shdocvw.dll en el directorio desde el que se ejecuta la herramienta. Si este archivo generado se ubica en el directorio Documents and Settings, causará problemas a Microsoft Internet Explorer y al Explorador de Windows. Cuando se reinicie el equipo, Windows buscará una copia de shdocvw.dll en el directorio Documents and Settings antes que en el directorio system32. Utilizará la copia que encuentre en Documents and Settings e intentará cargar los contenedores administrados. Internet Explorer y el Explorador de Windows no funcionarán correctamente, porque se basan en el motor de representación de shdocvw.dll ubicado en el directorio system32. Si se produce este problema, elimine la copia de shdocvw.dll del directorio Documents and Settings y reinicie el equipo.

Ejemplo

El comando siguiente genera MediaPlayer.dll y AxMediaPlayer.dll para el control Media Player msdxm.ocx.

aximp c:\systemroot\system32\msdxm.ocx

Vea también

Referencia

Herramientas de .NET Framework
Desensamblador de MSIL (Ildasm.exe)