Общие сведения об инструментах Visual Studio для среды выполнения Office

Статья
04/28/2010

Обновлен: Ноябрь 2007

Для выполнения решений, созданных с помощью Visual Studio Tools for Office, на компьютере конечного пользователя должна быть установлена среда выполнения Visual Studio Tools for Office. Среда выполнения включает управляемые сборки, обеспечивающие уровень взаимодействия между решением и приложением Microsoft Office, и неуправляемые компоненты, используемые приложением для загрузки решения.

Сведения об установке среды выполнения на компьютерах конечных пользователей см. в разделе Практическое руководство. Установка инструментальных средств Visual Studio Tools for Office.

В данном разделе содержатся следующие сведения:

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

Общее представление о различных версиях среды выполнения

Решения Visual Studio Tools for Office для различных версий Microsoft Office требуют разных версий среды выполнения. Версия среды выполнения определяется шаблоном проекта, использовавшимся для создания решения, а не версией системы Office, в которой выполняется решение.

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

Версия шаблона проекта	Требуемая версия среды выполнения Visual Studio Tools for Office на компьютере конечного пользователя	Версии Microsoft Office, которые могут использоваться для запуска решения на компьютере конечного пользователя
Проекты для системы Microsoft Office 2007	Visual Studio Tools for Office, версия 3.0 (cреда выполнения)	Система Microsoft Office 2007
Проекты для Microsoft Office 2003	Visual Studio 2005 Tools for Office Second Edition (среда выполнения)	Система Microsoft Office 2007 Microsoft Office 2003

Версия шаблона проекта

Требуемая версия среды выполнения Visual Studio Tools for Office на компьютере конечного пользователя

Версии Microsoft Office, которые могут использоваться для запуска решения на компьютере конечного пользователя

Проекты для системы Microsoft Office 2007

Visual Studio Tools for Office, версия 3.0 (cреда выполнения)

Система Microsoft Office 2007

Проекты для Microsoft Office 2003

Visual Studio 2005 Tools for Office Second Edition (среда выполнения)

Система Microsoft Office 2007

Microsoft Office 2003

Обе версии среды выполнения устанавливаются автоматически на компьютере разработчика при установке Microsoft Visual Studio Tools for Office, версия 3.0.

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

Существуют некоторые различия между сборками, включенными в разные версии среды выполнения. Дополнительные сведения см. в разделе Различия между сборками.

Примечание.
Среда Visual Studio 2005 Tools for Office Second Edition (среда выполнения) изначально выпускалась с Microsoft Visual Studio 2005 Tools for the 2007 Microsoft Office System (VSTO 2005 SE). Данная версия среды выполнения также используется решениями, предназначенными для системы Microsoft Office 2003, которые были созданы с помощью Microsoft Visual Studio Tools for Office, версия 3.0.

Среда Visual Studio 2005 Tools for Office Second Edition (среда выполнения) изначально выпускалась с Microsoft Visual Studio 2005 Tools for the 2007 Microsoft Office System (VSTO 2005 SE). Данная версия среды выполнения также используется решениями, предназначенными для системы Microsoft Office 2003, которые были созданы с помощью Microsoft Visual Studio Tools for Office, версия 3.0.

Расположение справочной документации по двум версиям среды выполнения

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

Система 2007. Данный раздел относится к среде Visual Studio Tools for Office, версия 3.0 (cреда выполнения).
Система 2003. Данный раздел относится к среде Visual Studio 2005 Tools for Office Second Edition (среда выполнения).

Общее представление о сборках среды выполнения

Сборки, включенные в среду выполнения Visual Studio Tools for Office, предоставляют следующие категории классов:

классы, используемые решением в целях автоматизации и расширения ведущего приложения;
инфраструктурные классы, позволяющие решению взаимодействовать с ведущим приложением.

Примечание.
При создании проекта Visual Studio Tools for Office автоматически добавляет ссылки на сборки, используемые для данного типа проекта. Некоторые сборки используются только в проектах уровня документа, в то время как другие — только в проектах уровня приложения.

При создании проекта Visual Studio Tools for Office автоматически добавляет ссылки на сборки, используемые для данного типа проекта. Некоторые сборки используются только в проектах уровня документа, в то время как другие — только в проектах уровня приложения.

Сборки среды выполнения набора средств Visual Studio для Office 3.0

В следующей таблице представлены сборки, включенные в среду Visual Studio Tools for Office, версия 3.0 (cреда выполнения). Данная версия среды выполнения также используется решениями, предназначенными для системы Microsoft Office 2007.

Документацию по пространствам имен и классам, включенным в эти сборки, см. в разделе Справочник по управляемому API выпуска 2007 системы Microsoft Office.

Имя сборки	Описание
Microsoft.Office.Tools.Common.v9.0.dll	Предоставляет следующие классы: базовый класс AddIn для надстроек уровня приложения; классы для создания панелей действий и смарт-тегов в настройках на уровне документа; классы для создания настраиваемых панелей задач в надстройках уровня приложения; классы для создания настроек ленты; классы ExcelLocale1033Attribute и ExcelLocale1033Proxy, используемые решениями Excel для управления кодом языка (LCID) для всех вызовов объектной модели Excel, зависящих от региональных параметров. Дополнительные сведения см. в разделе Форматирование данных в Excel при помощи различных региональных параметров.
Microsoft.Office.Tools.Excel.v9.0.dll	Предоставляет ведущие элементы и ведущие элементы управления для настроек на уровне документа Excel. Дополнительные сведения см. в разделе Общие сведения о ведущих элементах и элементах управления ведущего приложения.
Microsoft.Office.Tools.Outlook.v9.0.dll	Предоставляет классы, которые могут использоваться для создания пользовательских областей формы в надстройках Outlook.
Microsoft.Office.Tools.Word.v9.0.dll	Предоставляет ведущие элементы и ведущие элементы управления для настроек на уровне документа Word. Дополнительные сведения см. в разделе Общие сведения о ведущих элементах и элементах управления ведущего приложения.
Microsoft.Office.Tools.v9.0.dll	Предоставляет следующие классы: класс RemoteBindableComponent, предоставляющий возможности привязки данных для ведущих элементов управления в настройках на уровне документа; другие классы, являющиеся инфраструктурой Visual Studio Tools for Office, версия 3.0 (cреда выполнения), и не предназначенные для непосредственного использования разработчиком.
Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll	Предоставляет следующие классы: атрибут CachedAttribute и классы ICachedType, которые могут использоваться для кэширования объектов данных в настройках уровня документа; исключения, которые может вызывать среда Visual Studio Tools for Office; другие классы, являющиеся частью инфраструктуры Visual Studio Tools for Office, версия 3.0 (cреда выполнения), и не предназначенные для непосредственного использования разработчиком.
Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll	Предоставляет следующие классы: класс ServerDocument, который может использоваться для программного присоединения сборок настройки к документам и доступа к кэшированным данным в документах; несколько классов, представляющих иерархию кэшированных данных в настройке уровня документа.
Microsoft.VisualStudio.Tools.Office.Runtime.v9.0.dll	Предоставляет следующие классы: классы AddInSecurityEntry и UserInclusionList, которые могут использоваться для создания пользовательских записей в списке включения и предоставления полного доверие решениям Visual Studio Tools for Office для системы Microsoft Office 2007. Дополнительные сведения см. в разделе Доверие решениям Office при использовании списков включения (система 2007). другие классы, являющиеся частью инфраструктуры Visual Studio Tools for Office, версия 3.0 (cреда выполнения), и не предназначенные для непосредственного использования разработчиком.
Microsoft.VisualStudio.Tools.Office.AppInfoDocument.v9.0.dll Microsoft.VisualStudio.Tools.Office.Contract.v9.0.dll	Предоставляет классы, входящие в инфраструктуру Visual Studio Tools for Office, версия 3.0 (cреда выполнения). Эти классы не предназначены для использования напрямую из кода.

Сборки набора средств Visual Studio 2005 для среды выполнения Office Second Edition

В следующей таблице представлены сборки, включенные в Visual Studio 2005 Tools for Office Second Edition (среда выполнения). Данная версия среды выполнения также используется решениями, предназначенными для системы Microsoft Office 2003.

Документацию по пространствам имен и классам, включенным в эти сборки, см. в разделе Справочник по управляемому API выпуска 2003 системы Microsoft Office.

Имя сборки	Описание
Microsoft.Office.Tools.Common.dll	Предоставляет следующие классы: базовый класс AddIn для надстроек уровня приложения; классы для создания панелей действий и смарт-тегов в настройках на уровне документа.
Microsoft.Office.Tools.Excel.dll	Предоставляет ведущие элементы и ведущие элементы управления для настроек на уровне документа Excel. Дополнительные сведения см. в разделе Общие сведения о ведущих элементах и элементах управления ведущего приложения.
Microsoft.Office.Tools.Word.dll	Предоставляет ведущие элементы и ведущие элементы управления для настроек на уровне документа Word. Дополнительные сведения см. в разделе Общие сведения о ведущих элементах и элементах управления ведущего приложения.
Microsoft.VisualStudio.Tools.Applications.Runtime.dll	Предоставляет следующие классы: класс ServerDocument, который может использоваться для программного присоединения настроек к документам и доступа к кэшированным данным в документах; атрибут CachedAttribute и классы ICachedType, которые могут использоваться для кэширования объектов данных в настройках уровня документа; исключения, которые может вызывать среда Visual Studio Tools for Office; другие классы, являющиеся частью инфраструктуры Visual Studio 2005 Tools for Office Second Edition (среда выполнения) и не предназначенные для непосредственного использования разработчиком.

Различия между сборками

Некоторые сборки, включенные в среду Visual Studio 2005 Tools for Office Second Edition (среда выполнения), имеют другие имена в среде Visual Studio Tools for Office, версия 3.0 (cреда выполнения). Кроме того, одна из сборок, входящих в Visual Studio 2005 Tools for Office Second Edition (среда выполнения), была разделена на несколько сборок в среде Visual Studio Tools for Office, версия 3.0 (cреда выполнения).

В следующей таблице перечислены различия между сборками:

Имя сборки в среде Visual Studio 2005 Tools for Office Second Edition (среда выполнения)	Имя сборки в среде Visual Studio Tools for Office, версия 3.0 (cреда выполнения)
Microsoft.Office.Tools.Common.dll	Microsoft.Office.Tools.Common.v9.0.dll
Microsoft.Office.Tools.Excel.dll	Microsoft.Office.Tools.Excel.v9.0.dll
Microsoft.Office.Tools.Word.dll	Microsoft.Office.Tools.Word.v9.0.dll
Microsoft.VisualStudio.Tools.Applications.Runtime.dll	Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll Некоторые классы также были перемещены в следующие новые сборки: Microsoft.Office.Tools.v9.0.dll Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll

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

Среда выполнения Visual Studio Tools for Office включает несколько неуправляемых библиотек DLL, которые используются приложениями Microsoft Office для загрузки решений Visual Studio Tools for Office. Хотя работать напрямую с данными библиотеками DLL не следует, необходимо знать их назначение, чтобы лучше понимать архитектуру решений Visual Studio Tools for Office.

Сведения об использовании данных компонентов в процессе загрузки см. в разделах Архитектура настроек на уровне документа и Архитектура надстроек уровня приложения.

Загрузчик среды выполнения

Когда пользователь открывает настройку уровня документа или запускает надстройку, приложение Microsoft Office обращается к загрузчику среды выполнения. Этот компонент называется VSTOEE.dll.

Загрузчик среды выполнения обеспечивает загрузку версии среды выполнения Visual Studio Tools for Office, соответствующей версии системы Microsoft Office, в которой загружается надстройка. Хотя на одном компьютере могут быть установлены разные версии среды выполнения Visual Studio Tools for Office, одновременно может быть установлен только один экземпляр VSTOEE.dll. Им является экземпляр VSTOEE.dll, включенный в последнюю версию среды выполнения, установленную на данном компьютере.

Загрузчик решений

Загрузчик решений выполняет основную работу по загрузке сборки решения. Файл загрузчика решений может иметь разные имена в зависимости от версии среды выполнения Visual Studio Tools for Office. В среде Visual Studio Tools for Office, версия 3.0 (cреда выполнения), версия 3.0, загрузчик решений имеет имя VSTOLoader.dll. В среде Visual Studio 2005 Tools for Office Second Edition (среда выполнения) он имеет имя AddinLoader.dll.

Загрузчик решений выполняет несколько задач:

создает домен приложения для каждой сборки решения Visual Studio Tools for Office;
выполняет ряд проверок безопасности для подтверждения того, что сборка надстройки имеет разрешение на выполнение.

Загрузчик решений также выполняет ряд задач, специфичных для надстроек:

Реализует интерфейс IDTExtensibility2. IDTExtensibility2 — это COM-интерфейс, который должен реализовываться всеми надстройками для приложений Microsoft Office. С помощью этого интерфейса определяются методы, вызываемые приложением для взаимодействия с надстройкой;
реализует интерфейс IManagedAddin. Этот интерфейс используется приложениями Office, начиная с выпуска 2007, для загрузки надстроек Visual Studio Tools for Office. Дополнительные сведения см. в разделе Интерфейс IManagedAddin.

См. также

Поделиться через