Основные сборки взаимодействия Office

Чтобы использовать функции приложения Microsoft Office из проекта Office, необходимо применять основную сборку взаимодействия (PIA) для этого приложения. PIA позволяет управляемому коду взаимодействовать с объектной моделью на основе COM приложения Microsoft Office.

Замечание

Заинтересованы в разработке решений, которые расширяют возможности Office на нескольких платформах? Ознакомьтесь с новой моделью надстроек Office. Надстройки Office имеют небольшое пространство по сравнению с надстройками и решениями VSTO, и вы можете создавать их практически с помощью любой технологии веб-программирования, таких как HTML5, JavaScript, CSS3 и XML.

При создании нового проекта Office, Visual Studio добавляет ссылки на основные сборки межоперационных взаимодействий (Primary Interop Assemblies, PIA), необходимые для сборки проекта. В некоторых сценариях может потребоваться добавить ссылки на другие PИO (например, вы можете использовать функцию Microsoft Office Word для проекта в Microsoft Office Excel).

В этой статье описаны следующие аспекты использования пиА Microsoft Office в проектах Office:

Дополнительные сведения о основных сборках взаимодействия см. в разделе "Основные сборки взаимодействия".

Отдельные основные сборки взаимодействия для создания и запуска проектов

Visual Studio использует различные наборы личных данных на компьютере разработки. Эти различные наборы сборок находятся в следующих расположениях:

  • Папка в каталоге файлов программы

    Этот набор сборок используется при написании кода и сборки проектов. Visual Studio автоматически устанавливает эти сборки.

  • Глобальный кэш сборок

    Этот набор сборок используется во время некоторых задач разработки, таких как при запуске или отладке проектов. Visual Studio не устанавливает и не регистрирует эти сборки; Вам нужно сделать это самостоятельно.

Основные сборки взаимодействия в каталоге программных файлов

PIA автоматически добавляются в определённое место в файловой системе за пределами глобального кэша сборок при установке Visual Studio. При создании нового проекта Visual Studio автоматически добавляет ссылки на эти копии личных данных в проект. Visual Studio использует эти копии PIA вместо сборок в глобальном кэше сборок для разрешения типов при разработке и сборке проекта.

Если в глобальном кэше сборок зарегистрированы различные версии пиА, вы можете столкнуться с несколькими проблемами разработки. Новые копии PIA позволят вам избежать таких проблем.

Для Visual Studio 2017 и более поздних версий эти копии личных данных устанавливаются в следующие общие расположения на компьютере разработки:

  • %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 эти личные данные будут установлены в папку Visual Studio Tools for Office\PIA в папке %ProgramFiles% для этой версии Visual Studio. Например: %ProgramFiles(x86)%\Microsoft Visual Studio 14.0\Visual Studio Tools for Office\PIA\

Основные межплатформенные сборки в глобальном хранилище сборок

Для выполнения определенных задач разработки необходимо установить и зарегистрировать личные данные в глобальном кэше сборок на компьютере разработки. Как правило, PIAs устанавливаются автоматически при установке Office на компьютере разработчика. Дополнительные сведения см. в статье "Настройка компьютера для разработки решений Office".

ПиА Office не требуются на компьютерах конечных пользователей для запуска решений Office. Дополнительные сведения см. в статье "Проектирование и создание решений Office".

Использование функций нескольких приложений Microsoft Office в одном проекте

Каждый шаблон проекта Office в Visual Studio предназначен для работы с одним приложением Microsoft Office. Чтобы использовать функции в нескольких приложениях Microsoft Office или использовать функции в приложении или компоненте, не имеющего проекта в Visual Studio, необходимо добавить ссылку на необходимые PIA.

В большинстве случаев следует добавить ссылки на пиА, установленные Visual Studio в каталоге %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ . Эти версии сборок отображаются на вкладке Framework диалогового окна диспетчера ссылок . Для получения дополнительной информации см. руководство: Как нацеливать приложения Office через основные сборки взаимодействия.

Если вы установили и зарегистрировали пиА в глобальном кэше сборок, эти версии сборок отображаются на вкладке COM диалогового окна диспетчера ссылок . Избегайте добавления ссылок на эти версии сборок, так как при их использовании возникают некоторые проблемы разработки. Например, если вы зарегистрировали разные версии пиА в глобальном кэше сборок, проект автоматически привязывается к версии сборки, зарегистрированной последней, даже если указать другую версию сборки на вкладке COM диалогового окна диспетчера ссылок .

Замечание

Некоторые сборки добавляются в проект автоматически при добавлении сборки, ссылающейся на них. Например, ссылки на сборки Office.dll и Microsoft.Vbe.Interop.dll добавляются автоматически, когда вы добавляете ссылку на сборки Word, Excel, Outlook, Microsoft Forms или Graph.

Основные сборки межоперационного взаимодействия для приложений Microsoft Office

В следующей таблице перечислены основные сборки для взаимодействия, доступные для Office 2016, Office 2013 и Office 2010.


Приложение Office или компонент Основное имя межоперационной сборки
Библиотека объектов Microsoft Access 14.0

Библиотека объектов Microsoft Access 15.0		 Microsoft.Office.Interop.Access.dll
Библиотека объектов движка базы данных Microsoft Office 14.0

Библиотека объектов движка базы данных Microsoft Access 15.0 в Microsoft Office		 Microsoft.Office.Interop.Access.Dao.dll
Библиотека объектов Microsoft Excel 14.0

Библиотека объектов Microsoft Excel 15.0		 Microsoft.Office.Interop.Excel.dll
Библиотека объектов Microsoft Graph 14.0 (используется PowerPoint, Access и Word для графов)

Библиотека объектов Microsoft Graph 15.0		 Microsoft.Office.Interop.Graph.dll
Библиотека типов Microsoft InfoPath 2.0 (только для InfoPath 2007) Microsoft.Office.Interop.InfoPath.dll
Microsoft InfoPath XML-сборка для взаимодействия (только для InfoPath 2007) Microsoft.Office.Interop.InfoPath.Xml.dll
Библиотека объектов Microsoft Office 14.0 (общие функции Office)

Библиотека объектов Microsoft Office 15.0 (общие функции Office)		 office.dll
Элемент управления представлением Microsoft Office Outlook (можно использовать на веб-страницах и приложениях для доступа к папке "Входящие") Microsoft.Office.Interop.OutlookViewCtl.dll
Библиотека объектов Microsoft Outlook 14.0

Библиотека объектов Microsoft Outlook 15.0		 Microsoft.Office.Interop.Outlook.dll
Библиотека объектов Microsoft PowerPoint 14.0

Библиотека объектов Microsoft PowerPoint 15.0		 Microsoft.Office.Interop.PowerPoint.dll
Библиотека объектов Microsoft Project 14.0

Библиотека объектов Microsoft Project 15.0		 Microsoft.Office.Interop.MSProject.dll
Библиотека объектов Microsoft Publisher 14.0

Библиотека объектов Microsoft Publisher 15.0		 Microsoft.Office.Interop.Publisher.dll
Справочная библиотека веб-объектов Microsoft SharePoint Designer 14.0 Microsoft.Office.Interop.SharePointDesigner.dll
Справочная библиотека объектов страницы Microsoft SharePoint Designer 14.0 Microsoft.Office.Interop.SharePointDesignerPage.dll
Библиотека типов Microsoft Smart Tags 2.0 Примечание: умные теги устарели в Excel 2010 и Word 2010. Microsoft.Office.Interop.SmartTag.dll
Библиотека типов Microsoft Visio 14.0

Библиотека типов Microsoft Visio 15.0		 Microsoft.Office.Interop.Visio.dll
Библиотека типов для веб-сохранения Microsoft Visio 14.0

Библиотека Microsoft Visio 15.0 для сохранения в веб-формат		 Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Библиотека типов элементов управления рисованием Microsoft Visio 14.0

Библиотека типов элементов управления рисованием Microsoft Visio 15.0		 Microsoft.Office.Interop.VisOcx.dll
Библиотека объектов Microsoft Word 14.0

Библиотека объектов Microsoft Word 15.0		 Microsoft.Office.Interop.Word.dll
Расширяемость приложений Microsoft Visual Basic 5.3 Microsoft.Vbe.Interop.dll

Перенаправление связей сборок

При установке и регистрации межоперационных сборок Office (PIA) в глобальном кэше сборок (либо вместе с Office, либо путем установки распространяемого пакета для PIA), сборки перенаправления привязки также устанавливаются только в глобальном кэше сборок. Эти сборки гарантируют, что правильная версия основных библиотек взаимодействия загружается во время выполнения.

Например, когда решение, ссылающееся на сборку Office 2010, выполняется на компьютере с Office 2013, содержащим ту же основную библиотеку совместимости, сборка перенаправления привязки указывает среде выполнения .NET Framework загрузить основную библиотеку совместимости Office 2013.

Дополнительные сведения см. в разделе "Практическое руководство. Включение и отключение автоматического перенаправления привязки".

Связанный контент

  • Last updated on