使用Excel Add-in在工作表添加按钮遇Controls命名空间不存在问题

问题核心 #

你遇到的Controls不存在错误，是因为错误引用了Controls集合的归属对象，且可能缺少VSTO核心组件引用。

修正步骤 #

1. 修正代码逻辑
   你当前的this.Controls和this.Range都是错误的——Ribbon类没有这两个成员，必须使用转换后的VSTO工作表对象来操作控件，Range要从原生工作表获取。修正后的完整代码：

   private void createCheckFileButton_Click(object sender, RibbonControlEventArgs e)
   {
       // 获取原生Excel工作表对象
       Microsoft.Office.Interop.Excel.Worksheet nativeSheet = 
           Globals.ThisAddIn.Application.ActiveWorkbook.ActiveSheet as Microsoft.Office.Interop.Excel.Worksheet;
       // 转换为VSTO工作表对象（关键：只有VSTO对象才有Controls集合）
       Microsoft.Office.Tools.Excel.Worksheet vstoSheet = 
           Globals.Factory.GetVstoObject(nativeSheet);
   
       // 通过VSTO工作表的Controls添加按钮，绑定到A1单元格
       Microsoft.Office.Tools.Excel.Controls.Button button1 = 
           vstoSheet.Controls.AddButton(nativeSheet.Range["A1"], "button1");
       button1.Text = "OK";
       // 绑定按钮点击事件（示例功能）
       button1.Click += (s, args) => MessageBox.Show("工作表按钮触发！");
   }
   

2. 检查必要引用
   除了Microsoft.Office.Interop.Excel，必须添加以下VSTO专属引用（不要仅依赖NuGet，从VS的「添加引用」→「程序集」或「COM」中选择）：

   • Microsoft.Office.Tools.Excel
   • Microsoft.Office.Tools.Common
   • 确保你的项目是VSTO Excel外接程序项目（不是普通类库/控制台项目）——只有VSTO项目会自带Globals.Factory等核心API。

3. 避坑提示

   • 不要手动安装NuGet的Microsoft.Office.Interop.Excel包，VSTO项目创建时会自动添加兼容的Interop引用，手动安装可能导致版本冲突
   • 动态添加的VSTO控件仅在当前会话有效，关闭Excel后会消失；如果需要永久保留，要改用Excel原生表单控件（而非VSTO控件）

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