C#创建COM组件供VC调用的完整教程

结果与目标

本教程的目标是利用Visual Studio（以VS2008及后续版本为例）创建一个.NET类库，将其打包为COM组件，并通过VC++环境成功调用其导出的接口。实现的关键在于正确声明接口属性、完成强名称签名以及启用注册表集成。

准备条件

• Visual Studio：支持创建C#类库和智能设备/控制台项目（适用于VS系列）。
• .NET Framework SDK：确保安装完整的开发组件，以便使用 sn.exe 等命令行工具。
• C++ 编译器：用于构建VC++工程并验证生成的TLB文件。

C# 核心编程要点

在用C#创建COM时，务必牢记以下四个核心规则：

1. 导出类必须为公有（public）：这是COM对象可见性的基础。
2. 所有属性和方法必须为公有（public）：确保外部调用者能访问成员。
3. 接口方式导出：要导出的方法和属性必须在独立接口中声明。即使类本身是公开的，若未在接口中明确声明，也将无法导出到COM（但可直接供其他.NET程序调用）。
4. 事件接口化：所有需要回调的事件也必须通过接口暴露给COM。

第1步：新建C#解决方案与项目

打开Visual Studio，新建一个Visual C#项目。选择类型为“类库 (Class Library)”，并将项目名称命名为 MyCom 。

第2步：编写导出接口

为了演示，我们将仅导出一个简单的加法操作。以下是接口代码示例：

[Guid("154BD6A6-5AB8-4d7d-A343-0A68AB79470B")]
public interface MyCom_Interface
{
    [DispId(1)]
    int Add(int a, int b);
}

其中：
- [Guid(...)] 为该接口的全局唯一标识。可在命令行中输入 guidgen 生成，建议选择“Registry Format”格式。
- [DispId(n)] 为函数分派ID。若有多个函数，可依次递增标记（如 [DispId(2)]）。

第3步：创建事件接口

如需向COM公开事件，需单独定义一个接口：

[Guid("D11FEA37-AC57-4d39-9522-E49C4F9826BB"),
 InterfaceType(ComInterfaceType.InterfaceIsIDispatch)]
public interface MyCom_Events
{
    // 在此添加事件定义
}

此步骤将指定COM公开方式为IDispatch，常用于支持自动化和脚本交互的场景。

第4步：创建具体实现类

编写具体的业务逻辑类，并将其绑定至前述接口：

[Guid("2E3C7BAD-1051-4622-9C4C-215182C6BF58"),
 ClassInterface(ClassInterfaceType.None),
 ComSourceInterfaces(typeof(MyCom_Events))]
public class Class1 : MyCom_Interface
{
    public int Add(int a, int b)
    {
        return a + b;
    }
}

这里设置了 ComSourceInterfaces 来关联事件接口。整体完整代码如下（需引用 System.Runtime.InteropServices ）：

using System;
using System.Runtime.InteropServices;
using System.Text;

namespace MyCom
{
    [Guid("154BD6A6-5AB8-4d7d-A343-0A68AB79470B")]
    public interface MyCom_Interface
    {
        [DispId(1)]
        int Add(int a, int b);
    }

    [Guid("D11FEA37-AC57-4d39-9522-E49C4F9826BB"),
     InterfaceType(ComInterfaceType.InterfaceIsIDispatch)]
    public interface MyCom_Events
    {
    }

    [Guid("2E3C7BAD-1051-4622-9C4C-215182C6BF58"),
     ClassInterface(ClassInterfaceType.None),
     ComSourceInterfaces(typeof(MyCom_Events))]
    public class Class1 : MyCom_Interface
    {
        public int Add(int a, int b)
        {
            return a + b;
        }
    }
}

配置与注册流程

第5步：生成强名称密钥 (.snk)

大多数企业级或跨语言交互场景下，需要为程序集签名。进入Visual Studio 命令提示符，运行以下命令生成密钥：

sn -k MyCom.snk

将生成的 MyCom.snk 文件复制到项目的根目录下。

第6步：配置AssemblyInfo.cs

在 AssemblyInfo.cs 文件中添加以下行，使程序集引用刚才生成的密钥：

[assembly: AssemblyKeyFile("MyCom.snk")]

第7步：项目属性设置

在VS的项目属性中进行两项关键勾选：

1. 应用程序 > 程序集信息：选中“使程序集COM可见 (Make assembly COM-visible)”。
2. 生成 (Build) > 常规：选中“为COM互操作注册 (Register for COM interop)”。

第8步：编译与验证

执行生成（Build）操作。如果编译成功且在输出目录中看到了 MyCom.tlb 和 MyCom.dll 文件，说明DLL已成功封装。该TLB文件将作为头文件供VC++读取类型定义。

VC++ 端验证步骤

第9步：准备VC++工程

新建一个MFC对话框程序（也可以是普通Console程序）。将上一步生成的 MyCom.tlb 复制到该工程的根目录下。

第10步：在VC++代码中引入与测试

在相应的CPP文件中引入TLB，并使用智能指针进行实例化和调用：

// 包含TLB文件路径
#import "MyCom.tlb" named_guids

void CTestDlg::OnButton1()
{
    // 1. 初始化COM环境
    CoInitialize(NULL);

    try
    {
        // 2. 创建智能指针并实例化COM对象
        MyCom::MyCom_InterfacePtr p(__uuidof(MyCom::Class1));
        if (p == NULL)
        {
            AfxMessageBox("COM对象创建失败");
            return;
        }

        // 3. 调用方法
        int c = p->Add(3, 6);
        CString str;
        str.Format(_T("%d"), c);
        ::MessageBox(NULL, str, _T("计算结果"), MB_OK);
    }
    catch (_com_error& e)
    {
        ::MessageBox(NULL, e.ErrorMessage(), _T("错误"), MB_OK | MB_ICONERROR);
    }

    // 4. 释放资源
    CoUninitialize();
}

如果在运行时弹出“9”（即 3+6 的结果），则证明C#编写的COM组件已被VC++正确加载并调用。以上就是C#创建COM组件供VC调用的详细内容，更多关于C# COM互操作的技术资料请关注本站其它相关文章！