升级和迁移 Office 解决方案

如果您的 Microsoft Office 项目是在早期版本的 Visual Studio 中创建的,则必须升级该项目才能在 Visual Studio 2010 中使用它。 若要升级 Microsoft Office 项目,请在包括 Microsoft Office 开发人员工具的 Visual Studio 2010 版本中打开该项目。 有关升级过程的更多信息,请参见如何:升级 Office 解决方案。 有关包括 Microsoft Office 开发人员工具的 Visual Studio 2010 版本的更多信息,请参见将计算机配置为开发 Office 解决方案

当您升级 Microsoft Office 项目时,Visual Studio 将对项目进行若干更改。 其中一些更改取决于开发计算机上安装的 .NET Framework 和 Microsoft Office 的版本,以及项目是文档级项目还是应用程序级项目。

您也可以随时将 Office 项目的目标 Framework 从 .NET Framework 3.5 更改为 .NET Framework 4,反之亦然。 有关更多信息,请参见如何:面向特定的 .NET Framework 版本或配置文件。 如果更改目标 Framework,则可能需要执行一些附加步骤,才能在开发计算机和最终用户计算机上运行重定目标的解决方案,并且,如果您的项目使用某些功能,则项目将不再编译。 有关更多信息,请参见将 Office 解决方案迁移到 .NET Framework 4

提示

Visual Studio 2010 无法升级使用 Visual Studio 的早期版本创建的 InfoPath 表单模板项目。 Visual Studio 2010 中不支持这些类型的项目。

支持的项目升级版本

您可以升级使用 Visual Studio Tools for Office 的以下任何版本创建的 Office 项目:

  • Microsoft Visual Studio 2005 Tools for the Microsoft Office System.

  • Microsoft Visual Studio 2005 Tools for the 2007 Microsoft Office system (VSTO 2005 SE).

  • Microsoft Visual Studio Tools for the Microsoft Office system(3.0 版). Visual Studio 2008 附带了此版本的 Visual Studio Tools for Office。

Visual Studio 2010 不支持对使用 Visual Studio Tools for Office 版本 2003 创建的 Microsoft Office 项目进行升级。 若要继续在 Visual Studio 2010 中开发其中某一项目,请创建一个新 Office 项目,然后手动将代码移植到新项目中。

提示

Visual Studio Tools for Office 是 Visual Studio 早期版本中的 Microsoft Office 开发人员工具的名称。

对已升级项目所做的更改

当您升级 Microsoft Office 项目时,Visual Studio 将对项目进行以下更改:

  • 将项目面向的 Visual Studio Tools for Office 运行时的版本升级到 Visual Studio 2010 Tools for Office Runtime。

    有关 Visual Studio Tools for Office 运行时的更多信息,请参见 Visual Studio Tools for Office Runtime 概述

  • 更新项目面向的 .NET Framework 的版本(如有必要)。

  • 更新项目中的程序集引用。

  • 如果原始项目面向的是 Microsoft Office 的早期版本,则修改项目,使之面向开发计算机上安装的 Microsoft Office 的版本(Microsoft Office 2010 或 2007 Microsoft Office system)。 如果未安装任何 Microsoft Office 版本,则升级的项目将面向 2007 Microsoft Office system。

目标 .NET Framework

当您在 Visual Studio 2010 中升级 Visual Studio Tools for Office 项目时,Visual Studio 将在以下情况下修改目标 .NET Framework:

  • 原始项目以 .NET Framework 2.0 为目标。 在这种情况下,如果开发计算机上既安装了 .NET Framework 3.5 也安装了 .NET Framework 4,则 Visual Studio 将修改项目,使之面向 .NET Framework 3.5。 如果仅安装了 .NET Framework 4,则 Visual Studio 将修改项目,使之面向 .NET Framework 4。

  • 项目面向的是 .NET Framework 3.5,但开发计算机上仅安装了 .NET Framework 4。 在这种情况下,Visual Studio 将修改项目,使之面向 .NET Framework 4。

如果项目已经面向 .NET Framework 3.5,那么,在开发计算机上也安装了 .NET Framework 3.5 的情况下,Visual Studio 将不会在升级的项目中更新目标 Framework。

提示

如果 Visual Studio 将目标 Framework 更改为 .NET Framework 4,则可能需要执行一些附加步骤,才能在开发计算机和最终用户计算机上运行重定目标的解决方案,并且,如果您的项目使用某些功能,则项目将不再编译。 有关更多信息,请参见将 Office 解决方案迁移到 .NET Framework 4

下表总结了针对升级项目的目标 Framework 更改。

原始项目的目标 Framework

开发计算机上的 Framework 版本

升级的项目的目标 Framework

.NET Framework 2.0

.NET Framework 3.5

.NET Framework 3.5

.NET Framework 4

.NET Framework 3.5

注意注意
如果原始项目面向 .NET Framework 3.5 Client Profile,则升级的项目将面向 .NET Framework 3.5。

.NET Framework 2.0

.NET Framework 3.5

.NET Framework 4

.NET Framework 4

注意注意
如果原始项目面向 .NET Framework 3.5 Client Profile,则升级的项目将面向 .NET Framework 4 Client Profile。

如果在 Office 项目中面向 .NET Framework 4,那么,将可以使用在面向 .NET Framework 3.5 时不可用的某些功能。 有关更多信息,请参见设计和创建 Office 解决方案

程序集引用

Visual Studio 将升级项目中的以下程序集引用:

  • Microsoft Office 主互操作程序集。

  • Visual Studio Tools for Office Runtime中的程序集。 有关这些程序集的更多信息,请参见 Visual Studio Tools for Office Runtime 概述

  • 依赖程序集的新版本或更新版本。

但是,如果在创建原始项目之后向项目添加了程序集,则 Visual Studio 不会添加对这些程序集的新版本或更新版本的引用。 例如,如果升级的 Word 2003 外接程序项目同时引用 PowerPoint 2003 主互操作程序集,则 Visual Studio 将修改升级的项目,以引用 Word 2007 或 Word 2010 主互操作程序集。 但是,您必须手动更新对 PowerPoint 主互操作程序集的引用。

升级 Microsoft Office 2003 项目

默认情况下,如果在您升级面向 Microsoft Office 2003 的项目时,开发计算机上安装了 Microsoft Office 2010 或 2007 Microsoft Office system,则 Visual Studio 将修改该项目,使之面向已安装的 Microsoft Office 版本。 **“项目升级”选项页中的“始终升级到已安装的 Office 版本”**复选框用于控制此行为。 如果清除此复选框,则 Visual Studio 不会修改项目以面向 Microsoft Office 2010 或 2007 Microsoft Office system,并且您可能无法打开、调试或运行该项目。 有关此选项的更多信息,请参见“选项”对话框 ->“项目升级”

如果要升级面向 Microsoft Office 2003 的文档级自定义项和应用程序级外接程序,则需要考虑一些其他注意事项。

文档级项目

若要升级 Microsoft Office 2003 文档级项目,则必须在开发计算机安装相应的 Microsoft Office 2010 或 2007 Microsoft Office system 应用程序。 例如,您必须在计算机上安装 Word 2007 或 Word 2010,然后才能升级 Word 2003 项目。

在升级包含以二进制格式保存的文档的文档级项目时,必须决定是要将文档转换为 Open XML 格式,还是将文档保留为二进制格式。 除非出于特定原因需要使用旧格式,否则应选择 Open XML。 有关 Open XML 的更多信息,请参见Introduction to new file name extensions and Open XML Formats(新文件扩展名和 Open XML 格式简介)。

如果项目中的文档包含 Windows 窗体控件,还必须在升级项目之前安装 Visual Studio 2005 Tools for Office Second Edition 运行时。 如果未在升级项目之前在开发计算机上安装此版本的运行时,则升级后的项目中可能会出现编译或运行时错误。 升级完项目后,如果任何其他 Office 解决方案都没有使用 Visual Studio 2005 Tools for Office Second Edition 运行时,则可以从开发计算机将该运行时卸载。 可从 Microsoft 下载中心的以下位置以可再发行组件包的形式获取此版本的运行时: Microsoft Visual Studio 2005 Tools for Office Second Edition 运行时 (VSTO 2005 SE) (x86)

应用程序级项目

如果原始项目的解决方案文件包括一个已配置为安装应用程序级外接程序的安装项目,则 Visual Studio 会将该安装项目升级为 Visual Studio 2010 项目,但不会对该项目进行任何进一步更改。 如果要继续使用 Windows Installer 文件来部署外接程序,则必须修改安装项目以安装新的必备组件,例如 .NET Framework 4 或 .NET Framework 3.5、Visual Studio 2010 Tools for Office Runtime,以及(可选)外接程序引用的主互操作程序集。 有关更多信息,请参见使用 Windows Installer 部署 Office 解决方案

如果要使用 ClickOnce 来部署外接程序,则可以完全删除安装项目。 有关使用 ClickOnce 来部署外接程序的更多信息,请参见部署 Office 解决方案

请参见

任务

如何:升级 Office 解决方案

参考

“选项”对话框 ->“项目升级”

概念

将 Office 解决方案迁移到 .NET Framework 4