Win10+Excel2013下Excel自定义右键菜单加载项仅首次显示求助

针对你遇到的这个问题——Excel AddIn在Win7+Excel2010下正常运行，迁移到Win10+Excel2013后自定义右键菜单无法稳定显示，仅在首次启动时打开MessageBox.Show("MF")才会出现，后续打开工作簿就消失，且日志显示代码已经执行了菜单创建逻辑——我整理了几个针对性的排查方向，你可以逐一验证：

1. 调整菜单创建时机，适配Excel 2013的工作簿生命周期 #

Excel 2013开始对UI控件的生命周期管理更严格，关闭工作簿后可能会自动清理旧的CommandBar控件，而你只在ThisAddIn_Startup里创建一次菜单，后续打开新工作簿时就没有重新创建。

• 建议把菜单创建逻辑移到Application.WorkbookOpen事件中，同时先检查菜单是否已存在，避免重复添加：

  private void ThisAddIn_Startup(object sender, EventArgs e)
  {
      logger.Info("Started");
      Application.SheetBeforeRightClick += Application_SheetBeforeRightClick;
      // 订阅工作簿打开事件
      Application.WorkbookOpen += Application_WorkbookOpen;
  }
  
  private void Application_WorkbookOpen(Excel.Workbook Wb)
  {
      // 先检查菜单是否已存在，防止重复创建
      var existingBtn = Application.CommandBars["Cell"].Controls.Cast<Office.CommandBarControl>()
          .FirstOrDefault(c => c.Caption == "Upload to database");
      if (existingBtn == null)
      {
          CreateContextMenu();
      }
  }
  

2. 确认CommandBar控件的持久化设置 #

你在创建控件时用了Controls.Add的最后一个参数true（表示持久化），但Excel 2013对这个参数的处理可能和旧版本有差异，建议显式设置持久化属性：

• 在CreateContextMenu方法中添加一行：

  uploadToDatabase.Permanent = true;
  

• 另外，检查Excel信任中心的“自定义功能区”设置，确保没有限制AddIn的UI自定义权限。

3. 验证菜单创建时机是否过早（MessageBox的延迟提示） #

只有打开MessageBox.Show("MF")时首次能显示菜单，说明弹窗延迟了代码执行，让Excel的CommandBar完全初始化后再创建菜单才生效。这提示你当前的创建时机可能太早，Excel的UI还没准备好。

• 试试用短延迟的定时器来推迟菜单创建：

  private void ThisAddIn_Startup(object sender, EventArgs e)
  {
      logger.Info("Started");
      Application.SheetBeforeRightClick += Application_SheetBeforeRightClick;
      
      // 延迟200ms创建菜单，等待Excel UI初始化完成
      var initTimer = new System.Windows.Forms.Timer();
      initTimer.Interval = 200;
      initTimer.Tick += (s, args) =>
      {
          initTimer.Stop();
          CreateContextMenu();
      };
      initTimer.Start();
  }
  

4. 考虑改用推荐的Ribbon XML方式创建右键菜单 #

CommandBar属于旧版API，Excel 2013及以后微软推荐使用Ribbon XML来做UI自定义，兼容性和稳定性更好。

• 可以尝试用Ribbon XML定义右键菜单，示例片段如下：

  <customUI xmlns="http://schemas.microsoft.com/office/2009/07/customui">
    <contextMenus>
      <contextMenu idMso="ContextMenuCell">
        <button id="btnUploadToDB" label="Upload to database" onAction="UploadToDatabase_Click"/>
      </contextMenu>
    </contextMenus>
  </customUI>
  

  然后在AddIn中实现对应的UploadToDatabase_Click方法即可。

5. 排查权限与UAC影响 #

Win10的UAC权限比Win7严格，可能导致AddIn无法正常创建UI控件：

• 尝试以管理员身份运行Excel，看看菜单是否能正常显示。
• 检查Excel信任中心的“加载项”设置，确保你的AddIn被标记为受信任的发布者。

6. 确认控件是否已创建但未显示 #

有时候菜单控件已经创建，但被隐藏或被其他控件覆盖，你可以通过日志验证：

• 在CreateContextMenu方法末尾添加日志输出控件状态：

  logger.Info($"Menu button state: Visible={uploadToDatabase.Visible}, Enabled={uploadToDatabase.Enabled}");
  

• 在Application_SheetBeforeRightClick事件中遍历右键菜单的所有控件，确认你的菜单是否存在：

  private void Application_SheetBeforeRightClick(object Sh, Excel.Range Target, ref bool Cancel)
  {
      var cellMenu = Application.CommandBars["Cell"];
      foreach (Office.CommandBarControl ctrl in cellMenu.Controls)
      {
          logger.Info($"Found menu control: {ctrl.Caption}, Tag={ctrl.Tag}");
      }
  }
  

  如果日志里能看到你的菜单控件，但右键时看不到，可能是控件被隐藏或者位置被覆盖了。

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