使用VS创建VSTO项目常见错误
创建、 升级和打开项目
创建或打开 Office 项目时，可能会遇到以下错误。
无法创建项目
尝试创建或打开 Office 项目时出现错误，而 Visual Studio 没有足够的信息确定导致错误的原因。 请尝试关闭项目，退出 Visual Studio，然后重新启动。
如果你正在尝试创建文档级项目，则可能已在 Excel 或 Word 中打开与新项目中的文档同名的另一个文档。 请确保 Excel 或 Word 的所有其他实例均已关闭。
创建基于现有项目中的文档的新项目时丢失控件属性
如果基于现有项目中的文档创建新 Office 项目，则不会将该文档中任何控件的属性复制到新项目中。 必须为任何先前存在的控件手动重置其属性。 或者，可以通过以下方法保留控件属性：创建现有项目的副本（而不是创建新项目）；或者将现有项目加载到新解决方案（在设计器中），然后将控件从现有文档复制并粘贴到新文档中。
在创建基于现有工作簿的 Excel 工作簿项目时出错
如果你创建基于现有工作簿的新 Excel 工作簿项目，可能会看到以下错误的组合。
来自 Excel：“隐私问题警告: 此文档中包含宏、ActiveX 控件、XML 扩展包信息或 Web 组件。 其中可能包含个人信息，并且这些信息不能通过“文档检查器”删除。”
来自 Visual Studio：“设计器未能正确加载。”
如果尝试创建的项目基于其个人信息已使用文档检查器删除的工作簿，则可能会发生这些错误。 若要避免此错误，请在创建项目之前执行以下步骤：
- 在 Excel 中打开工作簿。
- 在 Excel 中打开“信任中心”。
- 上隐私选项选项卡上清除保存时从文件属性中删除个人信息复选框。
- 保存工作簿并关闭 Excel。
在迁移后，无法打开项目
在将 Office 解决方案迁移到 Microsoft Office 2010 之后，无法在仅安装了 2007 Microsoft Office system 的开发计算机中打开项目。 可以会出现下列错误。
“解决方案中的一个或多个项目未能正确加载。 请参阅输出窗口获取有关的详细信息。”
“无法创建项目，因为此计算机上未安装与此项目类型关联的应用程序。 必须安装与此项目类型关联的 Microsoft Office 应用程序。”
若要解决此问题，请编辑 .vbproj或 .csproj文件。 对于 Word 项目，将 HostPackage="{763FDC83-64E5-4651-AC9B-28C4FEB985A1}" 替换为 HostPackage="{6CE98B71-D55A-4305-87A8-0D6E368D9600}"。 对于 Excel 项目，将 HostPackage="{B284B16A-C42C-4438-BDCD-B72F4AC43CFB}" 替换为 HostPackage="{825100CF-0BA7-47EA-A084-DCF3308DAF74}"。 对于 Outlook 项目，将 HostPackage="{D2B20FF5-A6E5-47E1-90E8-463C6860CB05}" 替换为 HostPackage="{20A848B8-E01F-4801-962E-25DB0FF57389}"。
或者，确保仅在安装了 Microsoft Office 2010 的开发计算机上打开迁移的项目。
包含 Windows 窗体控件的已升级 Office 2003 文档级项目中的错误
如果升级 Microsoft Office 2003 文档级项目中，并且该文档包含 Windows 窗体控件，升级后的项目可能必须编译或运行时错误。 若要避免此问题，请在升级项目之前在开发计算机上安装 Visual Studio 2005 Tools for Office Second Edition Runtime。 可以从 Microsoft 下载中心（网址为： Microsoft Visual Studio 2005 Tools for Office Second Edition Runtime (VSTO 2005 SE) (x86)）下载此版本的运行时作为可再发行组件包。
完成项目升级后，如果它未被任何其他 Office 解决方案使用，你可以将 Visual Studio 2005 Tools for Office Second Edition Runtime 从开发计算机上卸载。
使用设计器
在文档级项目中使用文档、工作簿或工作表设计器时，可能会遇到以下错误。
未能正确加载的设计器
在以下情况下，Visual Studio 无法打开设计器：
- Excel 或 Word 已打开且显示模式对话框。 若要打开设计器，请查看 Excel 或 Word 是否有已打开的模式对话框，然后关闭所有打开的模式对话框。 如果没有打开的模式对话框，则可能需要先执行一些其他操作 Excel 或 Word 才可做出响应。
- 当前正在调试项目。 若要打开设计器，请停止或完成调试。
- Excel 启动时，开发计算机上安装的某个 Excel VSTO 外接程序正在显示一个对话框。 若要创建 Excel 文档级项目，则必须首先禁用该 VSTO 外接程序。
控件显示为黑色矩形文档或工作表
如果对文档或工作表中的控件进行分组，则 Visual Studio 不再识别这些控件。 分组的控件不能访问在属性窗口中，且显示为黑色矩形文档或工作表。 若要还原控件的功能，必须取消对控件进行分组。
Word 模板上的控件不可见 Visual Studio 中
如果在 Visual Studio 设计器中打开 Word 模板，则该模板中未嵌入文本中的控件可能不可见。 这是因为 Visual Studio 将打开中的 Word 模板正常视图。 若要查看控件，请单击视图菜单上，指向Microsoft Office Word 视图，然后单击打印布局。
插入剪贴画命令未在 Visual Studio 设计器中为 nothing
在 Visual Studio 设计器中打开 Excel 或 Word 时，单击剪贴画按钮上图例中功能区选项卡不会打开剪贴画任务窗格。 若要添加剪贴画，必须打开工作簿或位于主项目文件夹中的文档的副本 (而不是在副本\bin文件夹) 在 Visual Studio 外部添加剪贴画，然后保存工作簿或文档。
编写代码
在 Office 项目中编写代码时，可能会遇到以下错误。
使用 C# 时，Office 对象的某些事件不可访问
在某些情况下，当你尝试在 Visual C# 项目中访问 Office 主互操作程序集 (PIA) 类型的实例的特定事件时，可能会看到类似于以下形式的编译器错误。
“‘Microsoft.Office.Interop.Excel._Application.NewWorkbook’与‘Microsoft.Office.Interop.Excel.AppEvents_Event.NewWorkbook’之间存在二义性”
此错误意味着你正尝试访问的事件与对象的其他属性或方法同名。 若要访问该事件，你必须将对象强制转换为其事件接口。
具有事件的 Office PIA 类型实现两种接口：核心接口和事件接口；前者包含所有属性和方法，后者则包含由对象公开的事件。 这些事件接口使用命名约定objectname事件n_Event，例如
例如，Application.aspx) 对象具有一个
C#复制
private void ThisWorkbook_Startup(object sender, System.EventArgs e)
{
((Excel.AppEvents_Event)this.Application).NewWorkbook +=
new Excel.AppEvents_NewWorkbookEventHandler(ThisWorkbook_NewWorkbook);
}
void ThisWorkbook_NewWorkbook(Excel.Workbook Wb)
{
// Perform some work here.
}
有关 Office Pia 中的事件接口的详细信息，请参阅概述类和接口的 Office 主互操作程序集。
不能引用 Office PIA 中类项目面向.NET Framework 4或 .NET Framework 4.5
在面向 .NET Framework 4 或 .NET Framework 4.5 的项目中，默认情况下 Office PIA 中定义的类的代码不进行编译。Pia 中的类使用的命名约定objectname类，如Microsoft.Office.Interop.Word.DocumentClass.aspx)和WorkbookClass.aspx)。 例如，Word VSTO 外接程序项目中的以下代码将不进行编译。
C#复制
Word.DocumentClass document = (Word.DocumentClass) Globals.ThisAddIn.Application.ActiveDocument;
此代码将导致以下编译错误：
Visual Basic:"对类 'DocumentClass' 的引用是时不允许使用 NO-PIA 模式链接其程序集。"
Visual C#:"互操作类型 'Microsoft.Office.Interop.Word.DocumentClass' 不能嵌入。 请改用适用的接口。”
若要解决此错误，请修改代码以改为引用相应的接口。 例如，应引用 Document.aspx) 接口的实例，而不是引用 Microsoft.Office.Interop.Word.DocumentClass.aspx) 对象。
C#复制
Word.Document document = Globals.ThisAddIn.Application.ActiveDocument;
默认情况下，面向 .NET Framework 4 或 .NET Framework 4.5 的项目会自动嵌入 Office PIA 中的所有互操作类型。 发生此编译错误的原因是嵌入互操作类型功能仅适用于接口，而不适用于类。 有关 Office Pia 中接口和类的详细信息，请参阅概述类和接口的 Office 主互操作程序集。 有关 Office 项目中嵌入的互操作类型功能的详细信息，请参阅设计和创建 Office 解决方案。
无法识别对 Office 类的引用
某些类名称，例如应用程序，如位于多个命名空间Microsoft.Office.Interop.Word.aspx)和System.Windows.Forms。 为此，导入/使用语句的项目模板的顶部包含简写的限定常数，例如：
C#复制
using Word = Microsoft.Office.Interop.Word;
这种用法导入/使用语句需要区分对 Office 类使用 Word 或 Excel 限定符，例如：
C#复制
Word.Document doc;
如果使用非限定性声明，将出现错误，例如：
C#复制
Document doc; // Class is ambiguous
即使你已导入 Word 或 Excel 命名空间，并且有权访问其内部的所有类，则必须完全限定使用 Word 或 Excel，若要删除命名空间的多义性的所有类型。
生成项目
生成 Office 项目时，可能会遇到以下错误。
无法生成基于具有受限权限的文档的文档级项目
如果文档具有受限权限，则 Visual Studio 无法生成文档级项目。 如果你的项目包含具有受限权限的文档，将无法编译该项目，并且你将收到以下消息中的错误列表窗口。
“未能添加自定义项。”
如果要包括具有受限权限的文档，请在开发和生成解决方案时使用无限制的文档。 然后，在发布解决方案之后对发布位置中的文档应用受限权限。
删除 NamedRange 控件后发生编译器错误
如果从设计器中的非活动工作表的工作表中删除 NamedRange.aspx) 控件，则可能不会从项目中移除自动生成的代码，并可能发生编译器错误。 为了确保删除这些代码，应在删除 NamedRange.aspx) 控件前总是选中包含该控件的工作表，使其成为活动工作表。 如果在删除该控件时没有删除自动生成的代码，可激活该工作表并进行更改以将该工作表标记为已修改，从而令设计器删除这些代码。 重新生成项目时，将删除这些代码。
调试项目
调试 Office 项目时，可能会遇到以下错误。
发布和在开发计算机上安装解决方案时，将显示卸载提示
调试 Office 解决方案时，可能会出现以下错误。
“由于当前已安装另一个版本的自定义项且无法从该位置升级，无法安装该自定义项。”
此错误指示以前在开发计算机上发布和安装了 Office 解决方案。 若要避免出现此消息，请在调试解决方案之前从计算机上的已安装程序列表中卸载该解决方案。 或者，可以在开发计算机上创建另一个用户帐户以测试已发布解决方案的安装。
从 Visual Studio 不运行在 UNC 网络位置创建的文档级项目
如果在 UNC 网络位置为 Excel 或 Word 创建文档级项目，则必须将文档的位置添加到 Excel 或 Word 中的受信任位置列表中。 否则，尝试在 Visual Studio 中运行或调试该项目时，将不会加载自定义项。 有关受信任位置的详细信息，请参阅向文档授予信任。
调试后未正确停止线程
Visual Studio 中的 Office 项目遵循能够使调试器正确关闭程序的线程命名约定。 如果在解决方案中创建线程，则应使用前缀 VSTA_ 为每个线程命名，以确保在停止调试时会正确处理这些线程。 例如，你可能会设置Name等待网络事件的线程属性VSTA_NetworkListener。
无法运行或调试开发计算机上的任何 Office 解决方案
如果无法在开发计算机上运行或开发 Office 项目，则可能会出现下面的错误消息。
“无法加载自定义项，原因是无法创建应用程序域。”
在加载 Office 解决方案之前，Visual Studio 使用 Fusion（.NET Framework 程序集加载程序）来缓存程序集。 请确保 Visual Studio 可以写入 Fusion 缓存，然后重试。 有关详细信息，请参阅影像复制程序集。
使用编辑并继续后停止调试器中的文档级项目时的错误
如果你使用编辑和继续要更改对进行编码的文档级项目中 Excel 或 Word 项目处于中断模式时，可能会看到以下错误消息对话框中，如果你随后停止调试器。
“在当前状态下终止进程可能导致意外结果，包括数据丢失和系统不稳定。”
是否单击是或否在对话框中，Visual Studio 终止 Excel 或 Word 进程并停止调试器。 若要停止调试项目而不显示此对话框，请直接退出 Excel 或 Word，而不是在 Visual Studio 中停止调试器。