C#调用VC编写OCX控件的详细步骤与代码示例

环境准备与控件注册

在使用C#代码调用OCX之前，必须确保操作系统能够识别该ActiveX组件。首先需要将OCX文件注册到系统注册表中。

第1步：注册OCX控件

目的：使Windows系统识别并加载OCX文件。
操作入口：以管理员权限运行的命令提示符（CMD）或PowerShell。
执行命令：使用 regsvr32 工具指向具体的OCX文件路径。

regsvr32.exe alasunsmscon.ocx

完成状态：若注册成功，系统会弹出“DllRegisterServer succeeded”提示框；若失败请检查文件是否存在或权限不足。

生成C#可引用的代理程序集

C#不能直接引用原始的ActiveX二进制文件，需要使用 .NET Framework 提供的工具将其转换为 .NET 程序集。这一步通常会生成两个 DLL 文件：
- *.dll：包含控件属性、事件和方法的纯 .NET 包装器。
- Ax*.dll：包含 AxHost 派生类，用于实际创建和管理 ActiveX 实例。

第2步：使用 AxImp.exe 转换工具

目的：生成 C# 项目可以添加引用的托管 DLL。
操作入口：命令提示符，建议先配置好 .NET SDK 环境路径，或直接使用 Visual Studio 开发者命令提示符。
执行动作：输入 AxImp 命令并指定目标 OCX 文件。

AxImp.exe alasunsmscon.ocx

结果验证：当前目录下应新生成类似 alasun.dll 和 Axalasun.dll 的两个文件。这两个文件后续将在项目中引用。

在项目中使用 OCX 控件

第3步：添加程序集引用

目的：让编译器识别控件的类型定义。
操作入口：Visual Studio 解决方案资源管理器 → 右键“引用” → “添加引用” → 浏览找到上一步生成的 Ax*.dll 和 *.dll。

第4步：代码初始化与调用

目的：实例化控件对象并触发其生命周期方法。
关键参数：必须调用 CreateControl() 方法来激活底层 COM 对象，否则在访问其他属性时会抛出 AxHost.InvalidActiveXStateException 异常。

// 假设已添加对 Axalasun.dll 的引用，命名空间为 Axalasun
Axalasun.Axalasunsms sms = new Axalasun.Axalasunsms();
// 必须显式创建控件以初始化 COM 环境
sms.CreateControl();

// 此时即可正常调用控件的方法或设置属性
// sms.SomeProperty = "value";

控制台模式下的高级调用示例

如果在非 WinForms/WPF 的控制台应用程序中调用，或者处理更复杂的场景，需注意以下结构和线程安全细节。

第5步：实现主程序逻辑

控制台应用默认可能没有消息循环支持 ActiveX 的正常运作，因此需要严格遵循以下步骤：

1. 导入命名空间：引入生成的 Ax 库和普通库。
2. 声明静态实例：方便在全局作用域管理。
3. [STAThread] 特性：Main 方法必须标记此特性，因为 ActiveX 组件通常运行在单线程单元 (STA) 中。
4. 初始化与调用：

using System;
using System.Windows.Forms; // 可能需要此引用以兼容 AxHost
using AXHH; // 生成的 Ax 命名空间
using HH;   // 生成的普通命名空间

namespace Ocx_test
{
    public class Program
    {
        // 声明静态变量供全局访问
        static AXHH hh;

        [STAThread]
        static void Main(string[] args)
        {
            // 1. 初始化 OCX 控件实例
            hh = new AXHH();
            
            // 2. 强制创建底层控件，避免 InvalidActiveXStateException
            hh.CreateControl();

            // 3. 调用具体功能
            hh.ip = "127.0.0.1";
            hh.test();
        }
    }
}

第6步：多线程环境下的线程模型设置

如果需要在子线程中调用 OCX 控件，必须在启动线程之前设置公寓状态为 STA，否则会导致跨线程访问错误或初始化失败。

// 在启动新线程前
Thread myThread = new Thread(YourMethod);
myThread.SetApartmentState(ApartmentState.STA); // 关键设置
myThread.Start();

以上就是C#调用VC编写的OCX控件的详细流程与代码实现。核心在于注册、AxImp转换、CreateControl初始化以及STA线程模型的配置。更多关于C#开发ActiveX组件的资料请关注本站其它相关文章！