在C#中借助Excel-DNA封装Excel C API的XLOPER/XLOPER12

1. 先明确XLL的运行依赖 #

绝大多数基于Excel C API编写的XLL函数必须在Excel进程内运行，核心原因：

• XLOPER的内存由Excel管理，释放需调用Excel原生的xlFree接口
• 多数XLL函数内部会调用Excel的API（如类型转换、数据读取），没有Excel上下文根本无法执行
• 仅少数完全脱离Excel API的纯计算函数可能脱离环境运行，但这种情况极少，不建议优先尝试

所以最优路径是在Excel进程内实现C#与XLL的调用集成，别折腾脱离环境的方案。

2. 直接复用Excel-DNA的XLOPER封送逻辑 #

Excel-DNA内部已经完整实现了XLOPER/XLOPER12与.NET类型的转换、封送及内存管理，你可以直接复用：

• 创建Excel-DNA类库项目，将你的XLL文件添加到项目中，设置“复制到输出目录”为“始终复制”
• 用DllImport导入XLL中的目标函数，注意指定CallingConvention.Cdecl（XLL默认调用约定）
• 使用Excel-DNA提供的XlOper类型处理参数与返回值，无需手动定义复杂的XLOPER结构体

示例代码：

using System.Runtime.InteropServices;
using ExcelDna.Integration;

public class XllFunctionWrapper
{
    // 导入XLL中的目标函数，参数和返回均使用XlOper
    [DllImport("YourXllFile.xll", CallingConvention = CallingConvention.Cdecl)]
    private static extern XlOper CalculateComplexValue(XlOper inputParam1, XlOper inputParam2);

    // 封装为C#易用的上层方法
    public static object CallXllCalculation(object inputA, object inputB)
    {
        // 将.NET类型转换为XlOper
        var xlArg1 = XlOper.FromObject(inputA);
        var xlArg2 = XlOper.FromObject(inputB);
        
        // 调用XLL函数
        var xlResult = CalculateComplexValue(xlArg1, xlArg2);
        
        // 将XlOper转换回.NET类型
        var finalResult = xlResult.ToObject();
        
        // 显式释放内存（Excel-DNA会自动处理，但显式释放更稳妥）
        xlArg1.Free();
        xlArg2.Free();
        xlResult.Free();
        
        return finalResult;
    }
}

3. 不依赖Excel-DNA？手动封送XLOPER（不推荐） #

如果不想引入Excel-DNA依赖，只能手动定义XLOPER结构体并处理转换，但工作量极大且容易出错：

• 先对照Excel C API定义XLOPER结构体：

[StructLayout(LayoutKind.Explicit)]
public struct XLOPER
{
    [FieldOffset(0)]
    public ushort xltype; // 标记XLOPER的数据类型
    [FieldOffset(2)]
    public int intVal;
    [FieldOffset(2)]
    public double numVal;
    [FieldOffset(2)]
    public IntPtr strVal; // Excel分配的字符串内存
    [FieldOffset(2)]
    public IntPtr arrayVal; // 数组指针
    // 按需补充其他类型字段
}

• 导入XLL函数与Excel的xlFree接口用于内存释放：

[DllImport("YourXllFile.xll", CallingConvention = CallingConvention.Cdecl)]
private static extern XLOPER YourXllFunction(ref XLOPER inputArg);

[DllImport("excel.exe", CallingConvention = CallingConvention.StdCall)]
private static extern void xlFree(IntPtr pXlOper);

• 这种方式需要手动处理所有XLOPER类型（数值、字符串、数组、引用等）的转换，稍有不慎就会出现内存泄漏或程序崩溃，仅适合简单的单参数函数场景。

4. 脱离Excel上下文的尝试（谨慎） #

如果你的XLL函数确实是纯计算逻辑、完全未调用任何Excel API，可以尝试直接用DllImport导入，但必须确认：

• 函数内部的内存分配完全自主，未依赖Excel
• 没有使用Excel相关的错误处理或状态变量
• 这种情况极其少见，建议先在Excel进程内验证功能正常后，再尝试脱离环境测试。

内容的提问来源于stack exchange，提问作者Olórin