ExcelDNA通过事件处理器传递自定义类到宏是否存在限制？

我刚好之前处理过类似的ExcelDNA自定义类传递问题，确实这里存在一些限制，主要和Excel的COM交互机制以及ExcelDNA的类型处理逻辑有关，我给你拆解下原因和解决办法：

为什么传递自定义类会抛出类型不匹配异常？ #

Excel的对象模型本质是基于COM的，而ExcelDNA在处理回调事件时，对于简单类型（比如字符串、数值）会自动完成跨边界的类型转换，但自定义类属于复杂类型，默认情况下存在两个核心问题：

1. 自定义类没有被标记为COM可见，Excel的运行时无法识别这个类型；
2. ExcelDNA默认不支持复杂自定义对象的序列化/反序列化，导致传递时类型信息丢失，触发类型不匹配。

解决办法 #

针对这个问题，有几种可行的处理方案，你可以根据自己的场景选择：

1. 将自定义类标记为COM可见并满足COM要求 #

这是最直接的方案，让自定义类符合COM交互的规则：

• 给类添加[ComVisible(true)]特性，确保类是public的；
• 必须提供一个无参数的构造函数（COM要求）；
• 类的成员最好也是public的，方便访问。

示例代码：

[ComVisible(true)]
public class MyCustomClass
{
    public string DataName { get; set; }
    public int RecordCount { get; set; }

    // 必须的无参构造函数
    public MyCustomClass() { }
}

2. 实现序列化接口 #

如果自定义类包含复杂成员，建议实现序列化接口，让ExcelDNA能正确处理对象的序列化：

• 可以选择ISerializable接口，或者使用DataContract特性标记需要序列化的成员（更简洁）。

示例（DataContract方式）：

[ComVisible(true)]
[DataContract]
public class MyCustomClass
{
    [DataMember]
    public string DataName { get; set; }
    [DataMember]
    public int RecordCount { get; set; }

    public MyCustomClass() { }
}

3. 转成字符串中间层（JSON/XML） #

如果不想处理COM相关的配置，最省心的办法是把自定义类序列化为字符串（比如JSON），传递字符串后再在宏中反序列化回来：

// 功能区按钮的事件处理方法
public void MyMethod2()
{
    var customObj = new MyCustomClass 
    { 
        DataName = "SQL查询结果", 
        RecordCount = 100 
    };
    // 序列化为JSON字符串
    string jsonStr = Newtonsoft.Json.JsonConvert.SerializeObject(customObj);
    // 调用宏并传递字符串
    ExcelDnaUtil.Application.Run("FillSheetFromCustomObj", jsonStr);
}

// 宏方法
public void FillSheetFromCustomObj(string jsonStr)
{
    // 反序列化为自定义类
    var customObj = Newtonsoft.Json.JsonConvert.DeserializeObject<MyCustomClass>(jsonStr);
    // 后续填充工作表的逻辑
}

4. 检查功能区XML的参数配置 #

如果是在功能区XML中绑定的事件，确保参数类型声明正确。对于自定义类，可以先声明为object类型，然后在回调方法中强制转换：

<button id="btnCustomClass" label="传递自定义类" onAction="MyMethod2">
  <actionParameters>
    <parameter name="customObj" type="System.Object"/>
  </actionParameters>
</button>

额外注意事项 #

• 自定义类中不要包含非可序列化的成员（比如未标记的委托、非COM可见的嵌套类），否则会导致传递失败；
• 如果需要在VBA中也能访问这个自定义类，还需要将你的类库注册为COM组件，或者使用ExcelDNA的ExplicitRegistration特性辅助注册。

内容的提问来源于stack exchange，提问作者ElderPhoenix