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

  • Статья

Для использования компонентов приложения Microsoft Office из проекта Office необходимо использовать основную сборку взаимодействия (PIA) для приложения. Основная сборка взаимодействия позволяет управляемому коду взаимодействовать с основанной на COM объектной моделью приложения Microsoft Office.

Примечание.

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

При создании нового проекта Office Visual Studio добавляет ссылки на основные сборки взаимодействия, которые нужны для сборки проекта. В некоторых сценариях может потребоваться добавить ссылки на другие ЛИЧНЫЕ данные (например, вы можете использовать функцию Microsoft Office Word в проекте для Microsoft Office Excel).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В большинстве случаев следует добавить ссылки на пиА, установленные 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 lications

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


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

Библиотека объектов Microsoft Access 15.0		 Microsoft.Office.Interop.Access.dll
Библиотека объектов ядра СУБД Access Microsoft Office 14.0

Библиотека объектов ядра СУБД Access Microsoft Office 15.0		 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
Сборка взаимодействия XML Microsoft InfoPath (только для 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 for Applications Extensibility 5.3 Microsoft.Vbe.Interop.dll

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

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

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

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

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