演练：调试外接程序项目

2015-06-09

在 Visual Studio 2013 中，弃用外接程序。我们建议您将外接程序升级到 VSPackage 扩展。有关如何升级的更多信息，请参阅常见问题：将外接程序转换为 VSPackage 扩展。

本演练阐释如何创建一个基础的 Visual Studio 外接程序项目以及如何使用断点调试项目。有关详细信息，请参阅 Breakpoints and Tracepoints。

外接程序是经过编译的应用程序，它们使用 Visual Studio 自动化对象模型来操作或自动操作集成开发环境 (IDE)。有关详细信息，请参阅创建外接程序和向导。

备注

以下说明中的某些 Visual Studio 用户界面元素在计算机上出现的名称或位置可能会不同。您安装的 Visual Studio 版本以及使用的设置决定了这些元素。有关详细信息，请参阅在 Visual Studio 中自定义开发设置。

创建基础的 Visual Studio 外接程序项目

在菜单栏上，选择**“文件”，“新建**、“项目”。

将显示 New Project Dialog Box。
在**“项目类型”窗格中，展开“其他项目类型”，然后选择“扩展性”**。
在**“模板”窗格中，选择“Visual Studio 外接程序”**。
在“名称”字段中键入 SimpleAddIn。选择**“确定”**按钮。

Add-in Wizard 启动。
在“欢迎使用外接程序向导”页中，选择“下一步”按钮。
在“选择编程语言”页上，选择“使用 Visual C# 创建外接程序”，然后选择“下一步”。
在“选择应用程序主机”页上，接受默认选项，然后选择“下一步”。
在“输入名称和说明”页上，键入“简单的外接程序”作为名称，然后键入“用于阐释如何调试简单的外接程序。”作为说明。选择**“下一步”**。
在“选择外接程序选项”页上，选择“是，创建‘工具’菜单项”选项，接受剩余的默认值，然后选择“下一步”。
在“选择“帮助”中的“关于”信息”页上，选择“是的，我希望我的外接程序提供“关于”对话框信息。”选项，然后选择“下一步”。
在“摘要”页上，选择“完成”按钮。

“外接程序向导”将生成新的外接程序项目，并且打开 Connect.cs 文件。这是包含外接程序的代码的主类。
在“解决方案资源管理器”中，在项目的快捷菜单上，选择“添加”、“引用”，然后选择“添加新引用”按钮。

这允许在 System.Windows.Forms 命名空间中使用类型。

将出现 Add Reference 对话框。
在“.NET”选项卡，选择 System.Windows.Forms.dll，然后选择“确定”按钮。

在**“解决方案资源管理器”中，在“引用”**节点下将显示对 System.Windows.Forms 命名空间的引用。

此命名空间包含显示下面的代码示例中使用了消息框所必需的代码。
在 Connect.cs 中，在 SimpleAddIn 范围的顶部附近添加下面的语句以允许更轻松地使用 MessageBox 对象：
```
using System.Windows.Forms;
```

通过将 MessageBox.Show("Debugging a Simple Add-in"); 添加到 Exec 中的方法将 MessageBox 对象添加到外接程序中：

public void Exec(string commandName,
   vsCommandExecOption executeOption,
   ref object varIn, ref object varOut, ref bool handled)
{
   handled = false;
   if(executeOption ==
      vsCommandExecOption.vsCommandExecOptionDoDefault)
   {
      if(commandName == "MyAddin1.Connect.MyAddin1")
      {
         handled = true;
         MessageBox.Show("Debugging a Simple Add-in");
         return;
      }
   }
}

选择“全部保存”按钮以保存您的工作。

调试 Visual Studio 外接程序项目

在 Connect.cs 中，在语句左侧的空白处单击：
```
MessageBox.Show("Debugging a Simple Add-in")
```
出现一个红点（表示为断点），此行上的文本以红色突出显示。
在菜单栏上，依次选择**“调试”、“启动调试”**。

当前的 Visual Studio 会话（即调试器会话）将失去焦点，而正在调试的程序将在 Visual Studio 的另一个实例中打开。
在 Visual Studio 调试实例中的菜单栏上，依次选择“工具”“SimpleAdding”以运行外接程序。

这将转到您设置的断点处。
在调试实例的菜单栏上，依次选择“调试”、“Step Into”。

焦点切换回调试的程序。消息框打开并且指示您的外接程序已经执行。
选中“确定”按钮将消息框关闭。
在调试实例的菜单栏上，依次选择“调试”、“继续”。

关闭 Visual Studio 的调试实例。
在 Connect.cs 中，移除 MessageBox 语句旁的断点。

请参见

其他资源

创建外接程序和向导

自动化与扩展性参考