Обновление и перенос решений Office

Статья
04/28/2010

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

Используйте Мастер преобразования Visual Studio для обновления проектов из Visual Studio Tools for Office, версия 2003 и Microsoft Visual Studio 2005 Tools for Office до Visual Studio Tools for the Office system 3.0. Чтобы обновить решение Microsoft Office, откройте его в Visual Studio с установленным Visual Studio Tools for the Office system 3.0. Откроется Мастер преобразования Visual Studio, который выполнит требуемые шаги для завершения обновления. Дополнительные сведения см. в разделе Практическое руководство. Обновление решений Visual Studio для Office.

Мастер не изменяет код. Если производится обновление проекта надстройки Outlook 2003, разработчику может потребоваться обновить свой код вручную. Дополнительные сведения см. в разделе Проекты Outlook.

Ссылки на сборку

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

Например, если производится обновление проекта надстройки Word 2003, который имеет ссылки на сборку вспомогательного метода и основную сборку взаимодействия PowerPoint, то Мастер преобразования Visual Studio обеспечит корректность ссылок на основную сборку взаимодействия Word и сборку вспомогательного метода. Ссылку на основную сборку взаимодействия PowerPoint необходимо обновить вручную.

Обновления версий

Если установлена система Microsoft Office 2007, то мастер по умолчанию обновляет проекты Microsoft Office 2003 до уровня проектов системы Microsoft Office 2007. В то же время процесс для настроек уровня документа и надстроек уровня приложения отличается.

Проекты настроек на уровне документа

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

Чтобы обновить проект настройки уровня документа, необходимо иметь соответствующее приложение Office. Например, для обновления проекта настройки уровня документа для Word 2003 необходимо установить на компьютере Word 2003 или Word 2007.

Если установлен выпуск 2007 системы Microsoft Office, то Мастер преобразования Visual Studio предлагает преобразовать документ в один из форматов Open XML. Формат документа не следует преобразовывать, если по каким-либо причинам требуется использовать старый формат. Дополнительные сведения об этих форматах см. в разделе Общие сведения о новых расширениях имен файлов и XML-форматах Office.

Если при обновлении проекта установлен Microsoft Office 2003, проект продолжит использовать Microsoft Office 2003 в качестве целевой версии, а формат документа останется неизменным.

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

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

Если установлена система Microsoft Office 2007, а преобразование проектов надстройки версии 2003 в проекты версии 2007 с помощью Мастера преобразования Visual Studio не требуется, разработчик может изменить настройку по умолчанию, чтобы оставить проекты в версии Office 2003. Так как выпуск Office 2007 может размещать надстройки Office 2003, проект можно разрабатывать, компилировать и тестировать даже в том случае, если не установлен Microsoft Office 2003. Очистите параметр Всегда обновлять до установленной версии Office на странице параметров Обновление проекта. Дополнительные сведения см. в разделе Обновление проекта. Диалоговое окно "Параметры".

Мастер преобразования Visual Studio не может сделать проекты надстроек совместимыми с предыдущими версиями Office. Поэтому если при установленном Office 2003 производится обновление проекта надстройки версии 2007, то проект останется проектом версии 2007 после завершения обновления. Этот проект можно открывать, разрабатывать надстройку и компилировать код. Однако тестирование этого проекта будет невозможным, так как Office 2003 не размещает надстройки версии 2007.

Для обновления проекта надстройки уровня приложения наличие установленного Microsoft Office не обязательно.

Проекты Outlook

При обновлении проекта надстройки Outlook 2003 необходимо обновить имя класса ведущего элемента и ссылки на объект Microsoft.Office.Interop.Outlook.Application.

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

Имя класса ведущего элемента

Мастер преобразования Visual Studio не обновляет имя класса ведущего элемента. Имя класса остается равным ThisApplication. Изменение этого имени не обязательно. В то же время примеры кода в документации справки Visual Studio Tools for the Office system 3.0 используют имя класса ведущего элемента, равное ThisAddIn. Если код тестируется копированием и вставкой в собственный проект пользователя, то имя класса можно изменить на ThisAddIn, а затем реструктурировать это изменение имени в проекте. Сведения о реструктурировании кода в проекте C# см. в разделе Практическое руководство. Переименование идентификаторов. Сведения о реструктурировании кода в проекте Visual Basic см. в разделе Практическое руководство. Переименование идентификатора.

Ссылки на объект приложения

Мастер преобразования Visual Studio не изменяет код. Поэтому необходимо вручную изменить код, использующий один из следующих методов доступа к объекту Microsoft.Office.Interop.Outlook.Application:

ключевое слово this (для C#) или Me (для Visual Basic) внутри класса ThisApplication;
объект Globals.ThisApplication в коде вне класса ThisApplication.

Например, если класс ThisApplication содержит следующий код, то его следует обновить.

Me.ActiveExplorer()

this.ActiveExplorer();

Следующий код является заменой в обновленных проектах:

Me.Application.ActiveExplorer()

This.Application.ActiveExplorer();

Класс ведущего элемента ThisApplication в проектах Microsoft Visual Studio 2005 Tools for Office наследуется напрямую от класса Microsoft.Office.Tools.Outlook.Application. В то же время класс ведущего элемента ThisAddIn в проектах Visual Studio Tools for the Office system 3.0 не наследуется от Microsoft.Office.Tools.Outlook.Application. Вместо этого используется ссылка на активный объект приложения при помощи свойства Application класса ведущего элемента.

Обновление до версии Microsoft Office 2007

Если обновление до версии Microsoft Office 2007 производится после обновления проекта Visual Studio Tools for Office, при следующем открытии проекта отобразится Мастер преобразования Visual Studio.

В этом случае проекты надстроек для версии Office 2007, которые не были обновлены при установленном Office 2003, смогут запуститься, и их можно будет проверить нажатием клавиш F5 или CTRL+F5 в Visual Studio.

См. также

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