大网数据广告活动
.NET 与 C# 开发

Aximp.exe(Windows 窗体 ActiveX 控件导入程序)

· 52CE 我爱测

ActiveX 控件导入程序将 ActiveX 控件的 COM 类型库中的类型定义转换为 Windows 窗体控件。

ActiveX 控件导入程序将 ActiveX 控件的 COM 类型库中的类型定义转换为 Windows 窗体控件。

Windows 窗体只能承载 Windows 窗体控件,即从 xref:System.Windows.Forms.Control 派生的类。 Aximp.exe 生成可承载于 Windows 窗体上的 ActiveX 控件的包装器类。 这使你得以使用适用于其他 Windows 窗体控件的同一设计时支持和编程方法。

若要承载 ActiveX 控件,必须生成从 xref:System.Windows.Forms.AxHost 派生的包装器控件。 此包装器控件包含基础 ActiveX 控件的一个实例。 它知道如何与 ActiveX 控件通信,但它显示为 Windows 窗体控件。 这个生成的控件承载 ActiveX 控件并将其属性、方法和事件作为生成的控件的属性、方法和事件公开。

此工具会自动随 Visual Studio 一起安装。 若要运行此工具,请使用 Visual Studio 开发人员命令提示(或 Windows 7 中的 Visual Studio 命令提示)。 有关详细信息,请参阅命令提示。

在命令提示符处,键入以下内容:

语法

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

备注

参数 说明
文件 包含要转换的 ActiveX 控件的源文件的名称。 文件参数中必须具有扩展名 .dll 或 .ocx。
选项 说明
/delaysign 指定 Aximp.exe 使用延迟的签名对生成的控件进行签名。 必须使用 /keycontainer:、/keyfile: 或 /publickey: 选项指定此选项。 有关延迟签名过程的更多信息,请参见延迟为程序集签名。
/help 显示该工具的命令语法和选项。
/keycontainer: containerName 使用在 containerName 指定的密钥容器中找到的公钥/私钥对,对生成的控件进行强名称签名 。
/keyfile: filename 使用在 filename 中找到的发行者的正式公钥/私钥对,对生成的控件进行强名称签名 。
/nologo 取消显示 Microsoft 启动版权标志。
/out: filename 指定要创建的程序集的名称。
/publickey: filename 使用在 filename 指定的文件中找到的公钥,对生成的控件进行强名称签名 。
/rcw: filename 使用指定的运行时可调用包装器,而不用生成新的包装器。 你可以指定多个实例。 当前目录用于相对路径。 有关详细信息,请参阅运行时可调用包装器。
/silent 取消显示成功消息。
/source 生成 Windows 窗体包装器的 C# 源代码。
/verbose 指定详细模式;显示更多进度信息。
/? 显示该工具的命令语法和选项。

Aximp.exe 一次转换整个 ActiveX 控件类型库,并生成一组程序集,这些程序集包含在原始类型库中定义的类型的公共语言运行时元数据和控件实现。 生成的文件按照下面的模式命名:

COM 类型的公共语言运行时代理:progid.dll

ActiveX 控件的 Windows 窗体代理(其中 Ax 表示 ActiveX):Axprogid.dll

Note: 如果 ActiveX 控件的成员名称与 .NET Framework 中定义的名称匹配,则 Aximp.exe 在创建 AxHost 派生类时,将在成员名称前加上前缀“Ctl”。 例如,如果 ActiveX 控件有一个名为“Layout”的成员,由于在 .NET Framework 中定义了 Layout 事件,因此该成员在 AxHost 派生类中将重命名为“CtlLayout”。

可以使用 Ildasm.exe(IL 反汇编程序)之类的工具检查这些生成的文件。

不支持使用 Aximp.exe 为 ActiveX WebBrowser 控件 (shdocvw.dll) 生成 .NET 程序集。

在对 shdocvw.dll 运行 Aximp.exe 时,该工具始终会在运行它的目录中创建另一个名为 shdocvw.dll 的文件。 如果将此生成文件放在 Documents and Settings 目录下,则会导致 Microsoft Internet Explorer 和 Windows 资源管理器出现问题。 重启计算机时,Windows 会先在 Documents and Settings 目录查找 shdocvw.dll 的副本,然后再在 system32 目录查找。 它将使用在 Documents and Settings 目录中找到的副本,并尝试加载托管的包装器。 由于 Internet Explorer 和 Windows 资源管理器依赖于 system32 目录中的 shdocvw.dll 版本中的呈现引擎,因此它们将无法正常工作。 如果出现此问题,请在 Documents and Settings 目录中删除 shdocvw.dll 的副本,然后重启计算机。

通过对 shdocvw.dll 使用 Aximp.exe 来创建用于应用程序开发的 .NET 程序集也会导致问题。 在这种情况下,应用程序将同时加载 shdocvw.dll 的系统版本和生成版本,并可能为系统版本赋予更高的优先级。 此时,如果尝试在 WebBrowser ActiveX 控件内加载网页,用户可能会收到打开/保存对话框提示。 用户单击“打开”后,将在 Internet Explorer 中打开该网页 。 此情况只出现在运行 Internet Explorer 版本 6 或更早版本的计算机上。 若要防止此问题,请使用托管 xref:System.Windows.Forms.WebBrowser 控件或使用 Visual Studio 生成托管 shdocvw.dll,如如何:添加对类型库的引用中所述。

示例

下面的命令为媒体播放器控件 msdxm.ocx 生成 MediaPlayer.dll 和 AxMediaPlayer.dll。

aximp c:\systemroot\system32\msdxm.ocx  

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 mairaw)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。