如何在ExcelDNA动态编译UDF时使用ExcelFunction与ExcelArgument特性

核心问题 #

使用ExcelDNA开发时，通过Westwind.Scripting动态编译C#/VB/F#代码生成自定义函数，虽能正常注册调用，但无法触发ExcelFunction和ExcelArgument特性提供的函数向导功能；手动在代码中添加特性后，编译阶段提示找不到ExcelDna.Integration.dll，导致编译失败。

解决方案 #

1. 给动态编译上下文添加ExcelDna.Integration.dll引用 #

动态编译时必须显式引入ExcelDna.Integration.dll，否则编译器无法识别特性类型：

• 找到项目中ExcelDna.Integration.dll的实际路径（通常在NuGet包目录packages/ExcelDna.Integration.x.x.x/lib下，或ExcelDNA安装目录）
• 在Westwind.Scripting的ScriptCompiler实例中添加该dll的引用：

var compiler = new ScriptCompiler();
// 替换为你本地的ExcelDna.Integration.dll绝对路径
compiler.References.Add(@"C:\YourProject\packages\ExcelDna.Integration.1.6.0\lib\net472\ExcelDna.Integration.dll");
// 按需添加其他基础引用
compiler.References.AddRange(new[] { "System.dll", "System.Core.dll" });

2. 在动态代码中导入特性命名空间 #

在待编译的代码开头添加命名空间引用，让编译器识别特性：

// C#示例代码
using ExcelDna.Integration;

public class DynamicFunctions
{
    [ExcelFunction(Name = "DynamicSum", Description = "自定义求和函数", Category = "动态函数")]
    public static double DynamicSum(
        [ExcelArgument(Name = "数值1", Description = "第一个求和参数")] double num1,
        [ExcelArgument(Name = "数值2", Description = "第二个求和参数")] double num2)
    {
        return num1 + num2;
    }
}

3. 用ExcelDNA的程序集注册机制识别特性 #

不要手动注册单个方法，而是让ExcelDNA扫描编译后的程序集自动识别带特性的函数：

var compileResult = compiler.CompileScript(yourCode, ScriptLanguage.CSharp);
if (compileResult.Success)
{
    // 注册整个程序集，ExcelDNA会自动扫描并注册带特性的函数
    ExcelIntegration.RegisterAssembly(compileResult.CompiledAssembly);
}

注意事项 #

• 确保ExcelDna.Integration.dll的版本与ExcelDNA主程序版本一致，避免版本兼容问题
• 动态编译的目标框架要与ExcelDNA运行的框架匹配（比如ExcelDNA默认用.NET Framework 4.x，编译时不要选.NET Core/.NET 5+）
• 如果仍提示找不到dll，可以尝试将ExcelDna.Integration.dll复制到Excel的当前运行目录

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