Office 主互操作程序集

适用范围：Visual Studio Visual Studio for Mac Visual Studio Code

若要在 Office 项目中使用 Microsoft Office 应用程序的功能，你必须使用该应用程序的主互操作程序集 (PIA)。 PIA 使托管代码可与 Microsoft Office 应用程序基于 COM 的对象模型进行交互。

注意

有兴趣开发跨多个平台扩展 Office 体验的解决方案？ 查看新的 Office 加载项模型。 与 VSTO 外接程序和解决方案相比，Office 外接程序占用空间较小，你可以使用几乎任何 Web 编程技术（如 HTML5、JavaScript、CSS3 和 XML）来生成它们。

创建新的 Office 项目时，Visual Studio 会添加对生成该项目所需的 PIA 的引用。 在某些情况下，可能需要添加对其他 PIA (引用，例如，可以在 Microsoft Office Excel) 项目中使用 Microsoft Office Word 的功能。

本文介绍在 Office 项目中使用 Microsoft Office PIA 的以下方面：

用于生成和运行项目的单独主互操作程序集

在单个项目中使用多个 Microsoft Office 应用程序的功能

Microsoft Office 应用程序的主互操作程序集的完整列表

有关主互操作程序集的详细信息，请参阅 主互操作程序集。

Visual Studio 在开发计算机上使用不同的 PIA 集。 这些不同的程序集位于下列位置：

程序文件目录中的文件夹

编写代码和生成项目时，将使用这组程序集。 Visual Studio 会自动安装这些程序集。

全局程序集缓存

这组程序集用于某些开发任务，例如在运行或调试项目时。 Visual Studio 不安装和注册这些程序集;你需要自己做。

安装 Visual Studio 时，PIA 会自动添加到文件系统中全局程序集缓存外部的位置。 创建新项目时，Visual Studio 会自动将对这些 PIA 副本的引用添加到你的项目中。 Visual Studio 使用这些 PIA 副本（而非全局程序集缓存中的程序集）在开发和生成项目时解析类型引用。

在全局程序集缓存中注册不同版本的 PIA 时，可能会遇到几个开发问题。 添加的 PIA 副本将帮助你避免此类问题。

对于 Visual Studio 2017 及更高版本，这些 PIA 副本将安装到开发计算机上的以下共享位置：

%ProgramFiles%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\

(或 %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ 64 位操作系统)

注意

对于较旧版本的 Visual Studio，这些 PIA 将安装到该版本的 Visual Studio 文件夹下的 %ProgramFiles% Visual Studio Tools for Office\PIA 文件夹中。 例如：%ProgramFiles(x86)%\Microsoft Visual Studio 14.0\Visual Studio Tools for Office\PIA\

若要执行某些开发任务，必须在开发计算机上的全局程序集缓存中安装并注册 PIA。 通常，在开发计算机上安装 Office 时会自动安装 PIA。 有关详细信息，请参阅 配置计算机以开发 Office 解决方案。

最终用户计算机上不需要 Office PIA 即可运行 Office 解决方案。 有关详细信息，请参阅 设计和创建 Office 解决方案。

Visual Studio 中的每个 Office 项目模板旨在与单个 Microsoft Office 应用程序配合使用。 若要在多个 Microsoft Office 应用程序中使用功能，或在 Visual Studio 中没有项目的应用程序或组件中使用功能，必须添加对所需 PIA 的引用。

在大多数情况下，应添加对 Visual Studio 在 目录下安装的 PIA 的 %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ 引用。 这些版本的程序集显示在“引用管理器”对话框的“框架”选项卡上。 有关详细信息，请参阅 如何：通过主互操作程序集面向 Office 应用程序。

如果已在全局程序集缓存中安装并注册了 PIA，则这些版本的程序集将显示在“引用管理器”对话框的“COM”选项卡上。 避免添加对这些版本的程序集的引用，因为使用它们时可能会出现一些开发问题。 例如，如果在全局程序集缓存中注册了不同版本的 PIA，则项目将自动绑定到上次注册的程序集版本，即使你在“引用管理器”对话框的“COM”选项卡上指定了程序集的不同版本。

注意

添加一个引用某些程序集的程序集时，这些被引用的程序集将自动添加到项目中。 例如，在添加对 Office.dll Word、Excel、Outlook、Microsoft Forms 或 Graph 程序集的引用时，会自动添加对 和 Microsoft.Vbe.Interop.dll 程序集的引用。

下表列出了可用于 Office 2016、Office 2013 和 Office 2010 的主互操作程序集。

Microsoft Access 15.0 对象库

Microsoft Office 15.0 Access 数据库引擎对象库

Microsoft Excel 15.0 对象库

Microsoft Graph 15.0 对象库

Microsoft Office 15.0 对象库（Office 共享的功能）

Microsoft Outlook 15.0 对象库

Microsoft PowerPoint 15.0 对象库

Microsoft Project 15.0 对象库

Microsoft Publisher 15.0 对象库

Microsoft Visio 15.0 类型库

Microsoft Visio 15.0 Save As Web 类型库

Microsoft Visio 15.0 绘图控件类型库

Microsoft Word 15.0 对象库

在全局程序集缓存中安装并注册 Office PIA（通过 Office，或通过为 PIA 安装可再发行组件包）时，绑定重定向程序集也只会安装在全局程序集缓存中。 这些程序集可确保在运行时加载正确版本的主互操作程序集。

例如，当引用 Office 2010 程序集的解决方案在具有相同主互操作程序集的 Office 2013 版本的计算机上运行时，绑定重定向程序集会指示.NET Framework运行时加载 Office 2013 版本的主互操作程序集。

有关详细信息，请参阅 如何：启用和禁用自动绑定重定向。