Excel 365中C#开发的ContextMenu（CommandBarButton）功能莫名丢失

我之前也碰到过一模一样的坑！这种右键菜单按钮操作一段时间后事件不触发的情况，90%都是**.NET委托被垃圾回收（GC）给收走了**——这是COM互操作场景里的经典问题，很容易踩。

问题根源 #

当你在C#里给CommandBarButton绑定事件时，.NET会生成一个包装委托传递给COM对象。但如果这个委托只是局部变量（比如在某个初始化方法里临时创建的），GC会认为它没有被引用，在后续的垃圾回收周期里把它销毁。这时候再点击按钮，COM找不到对应的回调方法，事件自然就不触发了。

具体解决方案 #

1. 把按钮实例保存为类级别的成员变量

不要在方法里临时创建按钮，而是在你的Ribbon类（或者加载项的主类）里声明一个私有成员，用来持有按钮和对应的引用：

// 在你的Ribbon类顶部声明
private CommandBarButton _rightClickMenuButton;

// 初始化右键菜单的方法
private void InitializeRightClickMenu()
{
    // 获取右键菜单（比如单元格右键菜单）
    CommandBar cellMenu = Application.CommandBars["Cell"].Controls.Add(
        MsoControlType.msoControlButton, missing, missing, missing, true);
    
    _rightClickMenuButton = (CommandBarButton)cellMenu;
    _rightClickMenuButton.Caption = "我的自定义功能";
    // 绑定事件，此时委托会被类成员变量间接持有，不会被GC回收
    _rightClickMenuButton.Click += OnRightClickButtonClicked;
}

// 事件处理方法
private void OnRightClickButtonClicked(CommandBarButton Ctrl, ref bool CancelDefault)
{
    // 你的功能逻辑
    MessageBox.Show("右键菜单按钮触发了！");
}

2. 避免错误的“移除再添加”操作

如果你之前尝试过移除按钮再重新添加，一定要确保每次重新创建后，都把新的按钮实例赋值给那个类级别的成员变量，并且重新绑定事件。不要每次都创建新的局部变量，否则新的委托还是会被GC回收。

3. 排查是否有其他代码误释放了菜单

有时候其他逻辑（比如工作簿关闭、切换工作表的代码）可能会误清理CommandBar对象。可以在相关事件里加判断，确保只清理自己创建的按钮，比如：

private void Application_WorkbookBeforeClose(Workbook Wb, ref bool Cancel)
{
    // 遍历右键菜单，只删除自己创建的按钮
    foreach (CommandBarControl ctrl in Application.CommandBars["Cell"].Controls)
    {
        if (ctrl.Caption == "我的自定义功能")
        {
            ctrl.Delete();
            // 同时把类成员置空
            _rightClickMenuButton = null;
            break;
        }
    }
}

验证方法 #

你可以手动触发GC来测试是不是这个问题：在按钮正常工作时，执行GC.Collect(); GC.WaitForPendingFinalizers();，然后点击按钮，如果此时事件不触发，就坐实了是GC回收委托的问题，用上面的方法就能解决。

我当时就是把按钮实例改成类成员后，这个问题就彻底消失了，你可以试试这个方案！

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