Общие сведения о процессе построения решений Office
Обновлен: Ноябрь 2007
Построение решения Microsoft Office похожа на построение других приложений в Visual Studio. Однако существует несколько особенностей решений Office, которые следует иметь в виду.
Общие сведения о построении приложений см. в разделе Построение в Visual Studio.
Выходные файлы проектов выпуска 2007 системы Office.
Выходным каталогом проекта выпуска 2007 системы Office является имяПроекта\bin\release или имяПроекта\bin\debug. Нельзя выполнять построение в каталог развертывания.
Проекты уровня документа
При построении проекта уровня документа в выходной каталог проекта помещаются следующие элементы:
Копия документа проекта.
Сборка проекта и все связанные сборки, свойству Копировать локально которых назначено значение true.
Манифест приложения с расширением MANIFEST. Дополнительные сведения см. в разделе Манифесты приложений для решений Office (выпуск 2007 системы Microsoft Office).
Манифест развертывания с расширением VSTO. Дополнительные сведения см. в разделе Манифесты развертывания для решений Office (система 2007).
Файл базы данных программы (PDB).
Проекты уровня приложения
При построении проекта уровня приложения в выходной каталог проекта помещаются следующие элементы.
Сборка проекта и все связанные сборки, свойству Копировать локально которых назначено значение true.
Манифест приложения с расширением MANIFEST. Дополнительные сведения см. в разделе Манифесты приложений для решений Office (выпуск 2007 системы Microsoft Office).
Манифест развертывания с расширением VSTO. Дополнительные сведения см. в разделе Манифесты развертывания для решений Office (система 2007).
Файл базы данных программы (PDB) для сборки проекта.
При построении проектов уровня приложения на компьютере разработчика создаются записи в реестре, необходимые для загрузки надстройки. Дополнительные сведения см. в разделе Записи реестра для надстроек уровня приложения.
При построении проекта надстройки Outlook, содержащего области формы, в реестр добавляются следующие данные.
Один раздел на каждый класс сообщений, связанный с одной или несколькими областями форм.
Одну запись для каждой области формы и соответствующее значение, представляющее имя надстройки Outlook.
Приложение Outlook использует эту информацию для загрузки областей форм.
Выходные файлы проекта системы Office 2003.
Выходным каталогом проекта версии Office 2003 является имяПроекта\bin\release или имяПроекта\bin\debug. Нельзя выполнять построение в каталог развертывания.
Проекты уровня документа
При построении проекта уровня документа в выходной каталог проекта включаются следующие элементы:
Копия документа проекта.
Сборка проекта и все связанные сборки, свойству Копировать локально которых назначено значение true.
Манифест приложения (внедряется в документ). Дополнительные сведения см. в разделе Манифесты приложения и развертывания в решениях Office.
Файл базы данных программы (PDB).
Для решений Excel нельзя изменять путь выходного или рабочего каталога. При задании другого расположения рабочего каталога в области ОтладкаКонструктора проектов Excel изменит его на значение по умолчанию во время выполнения, когда документ будет открыт. Однако для решений Word расположение выходного каталога, как правило, можно изменять.
Проекты уровня приложения
При построении проекта уровня приложения в выходные файлы проекта включаются следующие элементы.
Сборка проекта и все связанные сборки, свойству Копировать локально которых назначено значение true.
Манифест приложения. Дополнительные сведения см. в разделе Манифесты приложения и развертывания в решениях Office.
Файл базы данных программы (PDB).
При построении проектов уровня приложения на компьютере разработчика создаются записи в реестре, необходимые для загрузки надстройки. Дополнительные сведения см. в разделе Записи реестра для надстроек уровня приложения.
Связанные сборки
Из проекта Visual Studio Tools for Office можно ссылаться на сборки (включая проекты библиотеки классов). Каждая сборка, на которую существует ссылка, имеет свойство Копировать локально. Свойство Копировать локально указывает, копируется ли сборка в выходной каталог. По умолчанию для этого свойства установлено значение true. Каждая связанная сборка, свойству Копировать локально которой назначено значение true, копируется в выходной каталог.
Обеспечение безопасности во время построения
Visual Studio автоматически настраивает параметры безопасности на компьютере разработчика, чтобы обеспечить предоставление решению доверия во время построения. Это позволяет решению выполняться во время отладки. Параметры безопасности отличаются в проектах различных версий Office.
Проекты выпуска 2007 системы Office
В проектах выпуска 2007 системы Microsoft Office пакет Visual Studio Tools for Office использует список включения и сертификаты для проверки издателя. Visual Studio автоматически создает временный сертификат для идентификации решений Office и добавляет запись в список включения о доверии данному сертификату.
Дополнительные сведения см. в разделе Безопасность в решениях Office (система 2007).
Проекты системы Office 2003
Для проектов Microsoft Office 2003 Visual Studio Tools for Office содержит логическое свойство Доверять расположению сборок. Это свойство отображается в окне Свойства среды Visual Studio. По умолчанию для этого свойства задано значение True. Если для этого свойства установлено значение True, при построении проекта Visual Studio предоставляет полное доверие сборке проекта, используя URL-адрес в качестве свидетельства.
Разрешения с полным доверием также предоставляются сборкам, на которые имеются ссылки, и вспомогательным сборкам, находящимся в выходной папке. Доверие предоставляется на уровне пользователя для сборок, находящихся на локальном компьютере. Поэтому для этих проектов не требуется учетная запись администратора. При повторном построении проекта в другом расположении разрешения с полным доверием для прежнего расположения удаляются. Дополнительные сведения о безопасности см. в разделе Требования безопасности при выполнении решений Office (для системы 2003).
Проверка расположения и предоставление доверия при каждом построении позволяет перемещать проекты и совместно использовать их без необходимости каждый раз изменять параметры безопасности вручную. Однако для изменения расположения проекта необходимо использовать инструменты, предоставляемые Visual Studio. При использовании внешних инструментов, таких как проводник, Visual Studio не сможет обновлять разрешения.
Сетевые проекты
Если сборка или документ расположены в сетевой папке, локальной политики безопасности (на уровне пользователя) недостаточно для запуска решения. Администратор должен предоставить полное доверие на уровне компьютера документам и сборкам, находящимся в сетевой папке, перед запуском решения. Дополнительные сведения о настройке политики безопасности см. в разделе Практическое руководство. Предоставление разрешений папкам и сборкам (Система 2003).
Для проектов уровня документа выпуска 2007 системы Office необходимо также добавить полный путь к расположению документа в список надежных папок Office. Дополнительные сведения см. в разделе Присвоение уровня доверия документам (система 2007).
Проверка настройки на уровне документа
Нажмите клавишу F5 для построения и отладки решения. При необходимости проверить решение Word 2003 или Word 2007 без выполнения отладки путем построения и открытия документа вне среды Visual Studio, необходимо закрыть проект перед открытием документа. При открытии документа Word в Visual Studio для процесса Word устанавливается флаг, запрещающий выполнение настроек. При открытии настроенного документа Word вне среды Visual Studio двойным щелчком файла в проводнике флаг также может помешать документу в выполнении настроек. При двойном щелчке для открытия файла Word открывает документ в том же процессе, что и уже выполняющийся документ. Поскольку документ открыт в Visual Studio, новый документ открывается в том же процессе и получает флаг, запрещающий выполнять настройки.
Проверка надстройки уровня приложения
Нажмите клавишу F5 для построения и отладки решения. Если проверка надстройки уровня приложения осуществляется посредством публикации и установки решения, перед повторной публикацией, изменением кода и проверкой решения (с помощью клавиши F5) следует удалить его. При установке опубликованного решения сборка надстройки устанавливается в кэш ClickOnce. Программой установки автоматически создаются разделы реестра, которые используются приложениями Office для поиска и загрузки сборки. Поскольку при повторном построении решения разделы реестра обновляются, перед публикацией или запуском новой версии необходимо удалить предыдущую.
Использование команды очистки
Для удаления файлов, созданных при построении проекта, с компьютера можно использовать команду Очистить в меню Построение среды Visual Studio. Команда Очистить удаляет все файлы в расположении выходных файлов построения. Для проектов на уровне приложения команда Очистить также удаляет записи реестра, созданные в процессе построения.
.gif "Примечание") Примечание. |
|---|
Команда Очистить не удаляет разрешения, которые были предоставлены сборкам решения при построении. Дополнительные сведения о способах удаления разрешений см. в разделе Практическое руководство. Удаление разрешений для папок и сборок (система 2003). |
Изменение целевой платформы на x64
По умолчанию целевой платформой является любой процессор. Если изменить целевую платформу на x64, можно будет компилировать проект, но решение запускаться не будет. Для использования процессора x64 в качестве целевой платформы необходимо, чтобы решение выполнялось в 64-разрядном процессе. Приложения Office выполняются в 32-разрядном процессе. Поэтому Office не сможет загрузить решение.
См. также
Задачи
Практическое руководство. Построение решений Office
Основные понятия
Отладка в проектах уровня документа