在应用程序级项目中进行调试

更新：2010 年 9 月

您可以使用用于其他 Visual Studio 项目的相同 Microsoft Visual Studio 工具调试应用程序级项目。 调试应用程序级项目时，也可以使用 Visual Studio 调试器功能，如用于在**“局部变量”**窗口中插入断点和视图变量的功能。 有关 Visual Studio 调试工具的更多信息，请参见使用 Visual Studio 进行调试。 有关应用程序级项目的更多信息，请参见 应用程序级外接程序的体系结构。

**适用于：**本主题中的信息适用于 Microsoft Office 2010 和 2007 Microsoft Office system 的应用程序级项目。有关更多信息，请参见按 Office 应用程序和项目类型提供的功能。

有关相关的视频演示，请参见 How Do I: Debug a VSTO Application?（如何实现：调试 VSTO 应用程序）。

启动和停止调试器

您可以像开始调试其他 Visual Studio 项目一样开始调试应用程序级项目；例如，可以按 F5 键。 在开始调试项目时，将启动目标 Office 应用程序的新进程并加载外接程序。 在停止调试器时，调试器将无条件终止该应用程序进程或分离该进程（如果已将调试器设置为分离的话）。 有关更多信息，请参见Debugging Shortcut Keys, Brief Scheme。

显示异常

如果使用 Visual Studio 中的 Office 开发工具创建的外接程序引发异常，则 Microsoft Office 应用程序将继续运行，而不显示该异常。 如果您想查看外接程序异常是何时引发的，请设置调试器在所有异常上中断。 有关更多信息，请参见 如何：处理 Office 项目中的错误。

也可以在可能会引发异常的代码周围插入 Try...Catch 语句。 有关如何使用 Try...Catch 语句的更多信息，请参见 如何：在 Visual Basic 中使用 Try...Catch 块测试代码 和 如何：使用 try/catch 处理异常（C# 编程指南）。

调试已禁用的外接程序

Microsoft Office 应用程序可能会禁用产生意外行为的外接程序。 Microsoft Office 应用程序禁用外接程序以防止该应用程序每次启动时加载有问题的代码。 但是，这也容易在典型的调试过程中导致意外行为。 有关如何重新启用外接程序的信息，请参见如何：重新启用已禁用的外接程序。

Microsoft Office 应用程序对外接程序使用的禁用类型有两种：硬禁用和软禁用。

硬禁用

当外接程序导致应用程序意外关闭时，可能会发生硬禁用。 如果在外接程序中的 Startup 事件处理程序正在执行时停止调试器，则也可能会在开发计算机上发生硬禁用。 在外接程序被硬禁用后，它会显示在应用程序的**“禁用项目”**列表中。

如果 Office 应用程序硬禁用使用 Visual Studio 中的 Office 开发工具创建的外接程序，则该应用程序将只禁用导致故障的外接程序。 使用 Visual Studio 中的 Office 开发工具为该 Office 应用程序创建的其他外接程序将继续加载。

软禁用

当外接程序产生的错误不会导致应用程序意外关闭时，可能会发生软禁用。 例如，如果外接程序在 Startup 事件处理程序正在执行期间引发未经处理的异常，则应用程序可能会软禁用该外接程序。 在外接程序被软禁用后，它会显示在应用程序的**“非活动应用程序外接程序”**列表中，并且应用程序会更改该外接程序的 LoadBehavior 注册表项值以指示它已卸载。 有关 LoadBehavior 注册表项的更多信息，请参见应用程序级外接程序的注册表项。

使用事件查看器对安装错误进行疑难解答

Visual Studio Tools for Office Runtime 针对安装或卸载 Office 解决方案时引发的所有异常，将消息写入 Windows 中的事件查看器。 可以使用这些消息来解决安装和部署问题。 有关更多信息，请参见 Office 解决方案的事件日志。

使用日志文件和错误消息对启动错误进行疑难解答

Visual Studio Tools for Office Runtime 可将启动过程中发生的所有错误写入日志文件中，或者在消息框中显示每个错误。 默认情况下，这些选项是禁用的。 可以通过创建环境变量来启用这些选项。

若要在消息框中显示每个错误，请创建一个名为 VSTO_SUPPRESSDISPLAYALERTS 的环境变量，并将其设置为 0（零）。 可以通过删除该环境变量或将其设置为 1（一）来取消显示消息。

若要将错误写入日志文件，请创建一个名为 VSTO_LOGALERTS 的环境变量，并将其设置为 1（一）。 Visual Studio Tools for Office Runtime 会在包含外接程序的部署清单的文件夹中创建日志文件；如果此操作失败，则会在本地 %TEMP% 文件夹中创建日志文件。 默认名称为 外接程序名称.vsto.log。 若要停止记录错误，请删除该环境变量或将其设置为 0（零）。

请参见

任务

如何：重新启用已禁用的外接程序

如何：处理 Office 项目中的错误

其他资源

生成和调试 Office 解决方案

应用程序级外接程序编程

修订记录

日期	修订记录	原因
2010 年 9 月	增加了有关使用事件查看器对安装错误进行疑难解答的部分。	信息补充。
2010 年 5 月	更正了有关日志记录错误的一些详细信息。	内容 Bug 修复