Проектирование и создание решений Office

Visual Studio предоставляет шаблоны проектов, которые можно использовать для создания решений Office различного типа. В этом разделе описываются шаблоны проектов и приведены рекомендации по созданию проектов Office. Сведения о реализации настроек кода и пользовательского интерфейса после создания проекта см. в статье "Разработка решений Office".

Область применения. Сведения в этом разделе относятся к проектам уровня документа и проектам надстроек VSTO. См. сведения о функциях, доступных по Приложение Office и типу проекта.

Примечание.

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

Создание проектов Office

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

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

Выбор версии платформа .NET Framework

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

  • .NET Framework 4

  • .NET Framework 4 (клиентский профиль)

  • .NET Framework 4.5

    Для запуска решения требуется платформа .NET Framework версия, выбранная для проекта. Например, если проект предназначен для платформа .NET Framework 4, на конечных компьютерах требуется платформа .NET Framework 4. В этом примере решение не будет работать, если на конечных компьютерах установлен только платформа .NET Framework 3.5.

    Если вы переносите проект надстройки VSTO, предназначенный для платформа .NET Framework 3.5, Visual Studio изменяет целевую платформу проекта на платформа .NET Framework 4 или более поздней в зависимости от установленной версии Office.

    Однако после того, как Visual Studio изменит целевую платформу, возможно, вам придется изменить некоторые части кода в проекте, если он использует определенные функции. Дополнительные сведения об изменении целевой платформы см. в статье "Практическое руководство. Назначение версии платформа .NET Framework". Дополнительные сведения об изменениях, которые могут потребоваться внести в проект, см. в статье "Миграция решений Office на платформа .NET Framework 4 или более поздней версии".

    Если Visual Studio изменяет целевую платформа .NET Framework для проекта и используете ClickOnce для развертывания решения, убедитесь, что в диалоговом окне предварительных требований выбрана соответствующая версия платформа .NET Framework. В случае изменения целевой платформы для своего проекта выбранное значение не будет изменяться автоматически. Дополнительные сведения см. в статье "Практическое руководство. Установка необходимых компонентов на компьютерах конечных пользователей для запуска решений Office".

Примечание.

Нельзя использовать платформа .NET Framework 3.5 или более ранних версий в проектах Office, созданных с помощью Visual Studio 2013. Для проектов Office, созданных с помощью Visual Studio 2013, требуются функции, которые впервые появились в профиле клиента платформа .NET Framework 4

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

По умолчанию на компьютерах конечных пользователей не требуется устанавливать основные сборки взаимодействия Office , если для каждого ссылки на Office PIA в проекте задано значение True, что является значением по умолчанию. В этом сценарии сведения о типе для типов PIA, используемых в решении, внедряются в сборку решения при сборке проекта. Во время выполнения внедренные сведения о типе используются вместо личных данных для вызова объектной модели на основе COM Приложение Office. Дополнительные сведения о том, как типы из piAs внедрены в решение, см. в разделе "Эквивалентность типов" и внедренные типы взаимодействия.

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

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

Клиентский профиль .NET Framework — это подмножество полной платформы .NET Framework. Если необходимо использовать только клиентские возможности платформы .NET Framework и требуется обеспечить наиболее быстрый режим развертывания для решения Office, то можно использовать клиентский профиль .NET Framework. Дополнительные сведения см. в разделе платформа .NET Framework профиле клиента.

При создании проекта Office, предназначенного для платформа .NET Framework 4, профиль клиента платформа .NET Framework 4 по умолчанию предназначен. Если вы хотите разработать для полного платформа .NET Framework 4, этот параметр необходимо задать после создания проекта. Дополнительные сведения см. в практическом руководстве по настройке конкретной версии .NET Framework.

Создание решений для 64-разрядного выпуска Microsoft Office

Microsoft Office доступен в 64- и 32-разрядном выпусках. Чтобы создать решения Office, которые могут выполняться в любом выпуске, целевой параметр платформы для проекта должен иметь значение Any CPU. Это значение по умолчанию для проектов Office. Дополнительные сведения см. в статье "Сборка решений Office".

Существуют отдельные 64-разрядные и 32-разрядные версии среды выполнения набор средств Visual Studio для Office, которые используются 64-разрядными и 32-разрядными выпусками Microsoft Office. Дополнительные сведения см. в набор средств Visual Studio для Office обзоре среды выполнения.

Сборки в решениях Office

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

Сборки в решениях Office загружаются приложением Office. После загрузки сборки код в сборке может отвечать на события, возникающие в приложении, например, если пользователь выбирает пункт меню. Код в сборке также может вызывать объектную модель для автоматизации и расширения приложения, и он может использовать любой из классов в платформа .NET Framework. Дополнительные сведения см. в разделе "Архитектура настроек на уровне документа" и "Архитектура надстроек VSTO".

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

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

Сборки в проектах уровня документа не внедряются в документ. Они хранятся в другом месте и обозначаются манифестом приложения документа.

Рекомендации по безопасности сборок

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

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

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

Связанные сборки

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