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

Записи реестра для надстроек уровня приложения

  • Статья

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

Применение

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

Тип проекта

  • Проекты уровня приложения

Версия Microsoft Office

  • Выпуск 2007 системы Microsoft Office

  • Microsoft Office 2003

Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

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

При построении проекта средства Visual Studio Tools for Office создают эти записи реестра на компьютере разработчика, упрощая отладку надстройки. Дополнительные сведения см. в разделе Общие сведения о процессе построения решений Office.

Дополнительные сведения о создании разделов реестра на компьютерах конечных пользователей при развертывании надстройки см. в разделах Развертывание решений Office (система 2007) и Развертывание надстроек уровня приложения (система 2003).

В этом разделе текст ИД_надстройки представляет уникальный идентификатор надстройки. По умолчанию идентификатором является имя проекта надстройки.

Записи реестра для выпуска 2007 системы Microsoft Office

Необходимые для надстроек выпуска 2007 системы Microsoft Office записи реестра расположены в следующем разделе реестра (это относится ко всем приложениям, кроме Microsoft Office Visio):

HKEY_CURRENT_USER\Software\Microsoft\Office\имя_приложения\Addins\ИД_надстройки

Записи реестра для Visio расположены в следующем узле реестра:

HKEY_CURRENT_USER\Software\Microsoft\Visio\Addins\ИД_надстройки

Bb386106.alert_note(ru-ru,VS.90).gifПримечание.

Приложения выпуска 2007 системы Microsoft Office опознают только те надстройки Visual Studio Tools for Office, которые зарегистрированы в разделе HKEY_CURRENT_USER. Это означает, что нельзя развернуть для всех пользователей компьютера надстройку Visual Studio Tools for Office для выпуска 2007 системы Microsoft Office, регистрируя ее в разделе HKEY_LOCAL_MACHINE.

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

Запись

Тип

Значение

Description

REG_SZ

Краткое описание надстройки.

Описание, отображаемое при выборе пользователем надстройки в области Надстройки диалогового окна Параметры в приложении Microsoft Office.

FriendlyName

REG_SZ

Описательное имя надстройки, которое отображается в диалоговом окне Надстройки СOM в приложении Microsoft Office. Значением по умолчанию является идентификатор надстройки.

LoadBehavior

REG_DWORD

Значение, определяющее, когда приложение пытается загрузить надстройку, и текущее состояние надстройки (загружена или выгружена).

По умолчанию данному параметру присвоено значение 3, которое означает, что надстройка загружается при запуске. Дополнительные сведения см. в разделе Значения LoadBehavior.

Manifest

REG_SZ

Полный путь манифеста развертывания надстройки. В качестве пути может быть указано расположение на локальном компьютере, сетевая папка (UNC) или веб-сервер (HTTP).

Bb386106.alert_note(ru-ru,VS.90).gifПримечание.
При построении надстройки на компьютере разработчика средства Visual Studio Tools for Office добавляют к данной записи реестра строку |vstolocal (т.е. знак вертикальной черты |, за которым следует строка vstolocal). Это помогает Visual Studio Tools for Office загрузить надстройку при ее запуске из Visual Studio на компьютере разработчика.

Записи реестра для областей формы Outlook

При создании пользовательской области формы в надстройке для Microsoft Office Outlook 2007 запись реестра используется для регистрации этой области формы в Outlook. Эта запись реестра располагается в следующем разделе реестра:

HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions\класс_сообщения

Дополнительные сведения см. в разделе Задание областей форм в реестре Windows. Дополнительные сведения об областях формы Outlook см. в разделе Создание областей форм Outlook.

Записи реестра для Microsoft Office 2003

Необходимые для надстроек Microsoft Office 2003 записи реестра расположены в следующих разделах реестра:

  • HKEY_CURRENT_USER\Software\Microsoft\Office\имя_приложения\Addins\ИД_надстройки

  • HKEY_CURRENT_USER\Software\Classes\ИД_надстройки\CLSID

  • HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID_надстройки}

  • HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID_надстройки}\InprocServer32

  • HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID_надстройки}\ProgID

  • HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID_надстройки}\Programmable

  • HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID_надстройки}\VersionIndependentProgID

Bb386106.alert_note(ru-ru,VS.90).gifПримечание.

Надстройки Visual Studio Tools for Office для Microsoft Office 2003 можно сделать доступными для всех пользователей компьютера, создав соответствующие разделы реестра в HKEY_LOCAL_MACHINE, а не в HKEY_CURRENT_USER.

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

  • Значение по умолчанию для записи реестра HKEY_CURRENT_USER\Software\Classes\ИД_надстройки\CLSID, созданное на компьютере разработчика при построении надстройки.

  • Элемент ProjectGuid в файлах проекта CSPROJ (для C#) или VBPROJ (для Visual Basic).

Bb386106.alert_note(ru-ru,VS.90).gifПримечание.

Если надстройка Microsoft Office 2003 развертывается в Windows Vista, некоторые записи реестра из следующего списка необходимо перенести в другое поддерево. Дополнительные сведения см. в разделе Записи реестра для надстроек Microsoft Office 2003 в Windows Vista.

HKEY_CURRENT_USER\Software\Microsoft\Office\<имя приложения>\Addins\<ИД надстройки>

Bb386106.alert_note(ru-ru,VS.90).gifПримечание.

Для надстроек Visio следует использовать следующий раздел реестра: HKEY_CURRENT_USER\Software\Microsoft\Visio\Addins\ИД_надстройки

Запись

Тип

Значение

Description

REG_SZ

Краткое описание надстройки.

FriendlyName

REG_SZ

Описательное имя надстройки, которое отображается в диалоговом окне Надстройки СOM в приложении Microsoft Office. Значением по умолчанию является идентификатор надстройки.

LoadBehavior

REG_DWORD

Значение, определяющее, когда приложение пытается загрузить надстройку, и текущее состояние надстройки (загружена или выгружена).

По умолчанию данному параметру присвоено значение 3, которое означает, что надстройка загружается при запуске. Дополнительные сведения см. в разделе Значения LoadBehavior.

Manifest

REG_SZ

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

HKEY_CURRENT_USER\Software\Classes\ИД_надстройки

Запись

Тип

Значение

(Default)

REG_SZ

Описание надстройки.

HKEY_CURRENT_USER\Software\Classes\ИД_надстройки\CLSID

Запись

Тип

Значение

(Default)

REG_SZ

Глобальный уникальный идентификатор класса (CLSID) надстройки.

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID надстройки>}

Запись

Тип

Значение

(Default)

REG_SZ

Описание надстройки.

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID надстройки>}\InprocServer32

Запись

Тип

Значение

(Default)

REG_SZ

—либо—

REG_EXPAND_SZ

Полный путь для загрузчика Visual Studio Tools for Office на компьютере, на котором запускается надстройка. Эта запись всегда должна иметь значение %CommonProgramFiles%\Microsoft Shared\VSTO\8.0\AddinLoader.dll.

Дополнительные сведения о загрузчике Visual Studio Tools for Office см. в разделе Общие сведения об инструментах Visual Studio для среды выполнения Office.

Bb386106.alert_note(ru-ru,VS.90).gifПримечание.
Чтобы использовать переменную среды для указания пути, следует выбрать для данной записи тип REG_EXPAND_SZ. В противном случае следует использовать тип REG_SZ.

ManifestLocation

REG_SZ

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

ManifestName

REG_SZ

Имя манифеста приложения надстройки.

ThreadingModel

REG_SZ

Потоковая модель. Этой записи должно быть присвоено значение Both.

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID надстройки>}\ProgID

Запись

Тип

Значение

(Default)

REG_SZ

Уникальный идентификатор надстройки.

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID надстройки>}\Programmable

Запись

Тип

Значение

(Default)

REG_SZ

Для этой записи задавать значение не следует.

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID надстройки>}\VersionIndependentProgID

Запись

Тип

Значение

(Default)

REG_SZ

Уникальный, независимый от версии идентификатор надстройки.

Записи реестра для надстроек Microsoft Office 2003 в Windows Vista

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

  • Пользователь запускает приложение Microsoft Office 2003 с маркером доступа полного администратора.

    —либо—

  • Пользователь отключил контроль учетных записей (UAC).

В этих случаях регистрационные разделы СОМ (то есть все разделы, которые определены в разделе HKEY_CURRENT_USER\Software\Classes) необходимо создавать в узле HKEY_LOCAL_MACHINE\Software\Classes.

Следует использовать поддерево MACHINE, поскольку в указанных случаях Windows Vista будет искать регистрационные разделы СОМ только в узле HKEY_LOCAL_MACHINE. Дополнительные сведения об изменении разделов реестра в установочном проекте по умолчанию см. в разделе Проекты установки для надстроек уровня приложения (система 2003).

Bb386106.alert_note(ru-ru,VS.90).gifПримечание.

В указанных случаях не следует перемещать разделы реестра, расположенные в разделе HKEY_CURRENT_USER\Software\Microsoft.

Значения LoadedBehavior

Запись LoadBehavior в разделе HKEY_CURRENT_USER\Software\Microsoft\Office\имя_приложения\Addins\ИД_надстройки содержит значение, указывающее, когда приложение пытается загружать надстройку, и текущее состояние надстройки (загружена или незагружена). По умолчанию при построении и развертывании надстройки данному параметру присваивается значение 3.

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

Значение (десятичное)

Смысл значения

Описание

0

Незагружена

Приложение не пытается загрузить надстройку при запуске. Пользователь может попытаться вручную загрузить надстройку с помощью диалогового окна Надстройки СOM приложения.

1

Загружена

Приложение не пытается загрузить надстройку при запуске. Пользователь может попытаться вручную загрузить надстройку с помощью диалогового окна Надстройки СOM приложения.

2

Загрузка при запуске | Незагружена

Приложение пытается загрузить надстройку при запуске.

Если приложению удается загрузить надстройку, значение LoadBehavior изменяется на 3.

3

Загрузка при запуске | Загружена

Приложение пытается загрузить надстройку при запуске.

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

8

Загрузка по запросу | Незагружена

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

Если приложению удается загрузить надстройку, значение LoadBehavior изменяется на 9.

9

Загрузка по запросу | Загружена

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

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

16

Загрузка при первом запуске

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

Если приложению удается загрузить надстройку при следующем запуске, значение LoadBehavior изменяется на 9.

См. также

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

Архитектура надстроек уровня приложения

Общие сведения о процессе построения решений Office

Развертывание решений Office (система 2007)

Развертывание надстроек уровня приложения (система 2003)

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

Архитектура средств Visual Studio для решений Office