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

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

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

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

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

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

• Полный список основных сборок взаимодействия для приложений Microsoft Office

Более подробную информацию о PIA см. Основные сборки взаимодействия.

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

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

• Папка в каталоге "Program Files".

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

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

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

Основные сборки взаимодействия в каталоге "Program Files".

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

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

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

• %ProgramFiles%\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\Office12

  (или %ProgramFiles(x86)%\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\Office12 в 64-разрядных операционных системах)

• %ProgramFiles%\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\Office14

  (или %ProgramFiles(x86)%\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\Office14 в 64-разрядных операционных системах)

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

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

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

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

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

Как правило, ссылки необходимо добавлять в основные сборки взаимодействия, которые были установлены Visual Studio в каталог ProgramFiles%\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\.Эти версии сборок отображаются на вкладке .NET диалогового окна Добавление ссылки.Дополнительные сведения см. в разделе Практическое руководство. Обращение к приложениям Office с помощью основных сборок взаимодействия.

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

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

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

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

Приложение или компонент Office	Имя основной сборки взаимодействия
Библиотека объектов Microsoft Access 12.0 Библиотека объектов Microsoft Access 14.0	Microsoft.Office.Interop.Access.dll
Библиотека объектов ядра СУБД Access Microsoft Office 2007 Библиотека объектов ядра СУБД Access Microsoft Office 14.0	Microsoft.Office.Interop.Access.Dao.dll
Библиотека объектов Microsoft Excel 12.0 Библиотека объектов Microsoft Excel 14.0	Microsoft.Office.Interop.Excel.dll
Библиотека объектов Microsoft Graph 12.0 (используется приложениями PowerPoint, Access и Word для графиков) Библиотека объектов Microsoft Graph 14.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 12.0 (Общие функциональные возможности Office) Библиотека объектов Microsoft Office 14.0 (Общие функциональные возможности Office)	office.dll
Элемент управления Microsoft Office Outlook View (может использоваться на веб-страницах и в приложениях для доступа к папке "Входящие")	Microsoft.Office.Interop.OutlookViewCtl.dll
Библиотека объектов Microsoft Outlook 12.0 Библиотека объектов Microsoft Outlook 14.0	Microsoft.Office.Interop.Outlook.dll
Библиотека объектов Microsoft PowerPoint 12.0 Библиотека объектов Microsoft PowerPoint 14.0	Microsoft.Office.Interop.PowerPoint.dll
Библиотека объектов Microsoft Project 12.0 Библиотека объектов Microsoft Project 14.0	Microsoft.Office.Interop.MSProject.dll
Библиотека объектов Microsoft Publisher 12.0 Библиотека объектов Microsoft Publisher 14.0	Microsoft.Office.Interop.Publisher.dll
Справочная библиотека веб-объектов Microsoft SharePoint Designer 12.0 Справочная библиотека веб-объектов Microsoft SharePoint Designer 14.0	Microsoft.Office.Interop.SharePointDesigner.dll
Справочная библиотека объектов страниц Microsoft SharePoint Designer 12.0 Справочная библиотека объектов страниц 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 12.0 Библиотека типов Microsoft Visio 14.0	Microsoft.Office.Interop.Visio.dll
Библиотека типов Microsoft Visio 12.0 для сохранения веб-страниц Библиотека типов Microsoft Visio 14.0 для сохранения веб-страниц	Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Библиотека типов элементов управления рисованием Microsoft Visio 12.0 Библиотека типов элементов управления рисованием Microsoft Visio 14.0	Microsoft.Office.Interop.VisOcx.dll
Библиотека объектов Microsoft Word 12.0 Библиотека объектов Microsoft Word 14.0	Microsoft.Office.Interop.Word.dll
Microsoft Visual Basic for Applications Extensibility 5.3	Microsoft.Vbe.Interop.dll

Построение перенаправленных сборок

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

Каждая сборка перенаправления привязки имеет имя в формате Policy.11.0. имя_PIA.dll или Policy.12.0.имя_PIA.dll, например Policy.11.0.Microsoft.Office.Interop.Excel.dll или Policy.12.0.Microsoft.Office.Interop.Excel.dll.

См. также

Задачи

Практическое руководство. Обращение к приложениям Office с помощью основных сборок взаимодействия

Основные понятия

Решения InfoPath

Решения PowerPoint

Решения Project

Общие сведения об объектной модели Visio

Другие ресурсы

Общие сведения об объектной модели Excel

Общие сведения об объектной модели Outlook

Общие сведения об объектной модели Word

Общие справочные материалы (разработка решений Office в Visual Studio)