Excel-DNA静态函数正常但OnKey事件无法触发的问题求助

问题代码 #

public class Main : IExcelAddIn
{
    public void AutoOpen()
    {
        dynamic app = ExcelDnaUtil.Application;
        app.OnKey("^N", "FormatNumbers");
    }

    public void AutoClose()
    {
    }
}

public class KeyboardShortcuts
{
    public static void FormatNumbers()
    {
        dynamic app = ExcelDnaUtil.Application;
        dynamic selection = app.Selection;
        selection.NumberFormat = "#,##0;[Red]-#,##0";
    }
}

public static class MyFunctions
{
    [ExcelFunction(Description = "My first .NET function")]
    public static string SayHello(string name)
    {
       return "Hello " + name;
    }
}

问题背景 #

• 使用.NET 8.0构建Excel-DNA加载项，目标平台为Windows-7.0，官方文档标注仅支持.NET 6.0，但项目构建正常，SayHello静态函数可正常使用
• 通过Ctrl+N触发FormatNumbers时弹出报错：Cannot run the macro "FormatNumbers". The macro may not be available or all the macros may be disabled.
• 已配置Excel信任中心允许所有宏运行，加载项文件夹及子文件夹设为受信任，排除权限、杀毒软件干扰

问题排查与修复 #

核心原因 #

Excel-DNA中，通过Application.OnKey调用的方法必须被注册为可识别的宏，且宏名称需要正确指向方法的完整路径，否则Excel无法找到对应的方法。

具体修复步骤 #

1. 为FormatNumbers添加宏注册特性

修改KeyboardShortcuts类，给静态方法添加[ExcelCommand]特性，让Excel-DNA将其注册为可调用的宏：

public class KeyboardShortcuts
{
    [ExcelCommand(MenuName = "格式工具", MenuText = "格式化选中数字")]
    public static void FormatNumbers()
    {
        dynamic app = ExcelDnaUtil.Application;
        dynamic selection = app.Selection;
        selection.NumberFormat = "#,##0;[Red]-#,##0";
    }
}

2. 修正OnKey的宏名称（或改用特性绑定快捷键）

• 方式一：指定完整方法路径
  如果继续使用AutoOpen中的OnKey调用，需要传入包含命名空间和类名的完整宏名称：

  // 替换YourNamespace为实际的命名空间
  app.OnKey("^N", "YourNamespace.KeyboardShortcuts.FormatNumbers");
  

• 方式二：用ExcelCommand直接绑定快捷键（更简便）
  无需手动调用OnKey，直接在特性中指定快捷键，由Excel-DNA自动处理注册：

  [ExcelCommand(MenuName = "格式工具", MenuText = "格式化选中数字", ShortCut = "^N")]
  public static void FormatNumbers()
  {
      // 方法内容不变
  }
  

3. 验证.NET版本兼容性

虽然SayHello能正常运行，但.NET 8.0不在Excel-DNA官方支持范围内，可能存在隐性兼容问题。建议临时切换到.NET 6.0编译测试，确认问题是否因版本不兼容导致。

额外检查项 #

• 确认加载项的.dna配置文件中，已正确引用包含KeyboardShortcuts类的程序集
• 重新生成加载项并重启Excel，避免缓存残留导致的识别问题

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