Пошаговое руководство. Развертывание документа и сборки в локальной папке (система 2003)

Статья
04/28/2010

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

Применение
Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Тип проекта Проекты уровня документа Версия Microsoft Office Microsoft Office 2003 Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

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

Тип проекта

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

Версия Microsoft Office

Microsoft Office 2003

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

В этом пошаговом руководстве демонстрируется, как на компьютере разработчика развернуть настройку на уровне документа в новую папку так, чтобы документ и сборка находились в одной папке. Этот тип развертывания называется локально-локальной моделью развертывания.

Дополнительные сведения о развертывании решения см. в разделе Модели развертывания (система 2003). Дополнительные сведения о настройках уровня документа см. в разделе Архитектура настроек на уровне документа.

В данном пошаговом руководстве представлены следующие задачи:

Предоставление полного доверия сборке решения Visual Studio Tools for Office, расположенного в локальной папке.

Обязательные компоненты

Для выполнения инструкций данного пошагового руководства необходимы следующие компоненты:

Visual Studio Tools for Office (необязательный компонент Visual Studio 2008 Professional и Visual Studio Team System);

Microsoft Office Word 2003 или Microsoft Office Excel 2003.

Примечание.
В этом руководстве предполагается, что пользователь осуществляет развертывание решения Word. Если шаги этого руководства требуется выполнить для решения Excel, замените во всех примерах кода имя проекта Word на имя своего проекта Excel.

В этом руководстве предполагается, что пользователь осуществляет развертывание решения Word. Если шаги этого руководства требуется выполнить для решения Excel, замените во всех примерах кода имя проекта Word на имя своего проекта Excel.

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

Создание решения для развертывания

На первом этапе необходимо создать базовое решение Visual Studio Tools for Office, которое затем будет развернуто. Если уже имеется решение, которое можно развернуть, пропустите раздел "Создание решения для развертывания" и перейдите к разделу "Развертывание решения".

Создание решения для развертывания

Создайте проект документа Word с именем WordDeployment, используя шаблон проекта для Office 2003.

В мастере выберите Создать новый документ. Дополнительные сведения см. в разделе Практическое руководство. Создание проектов Visual Studio Tools for Office.
В Обозревателе решений щелкните правой кнопкой мыши файл кода ThisDocument и выберите в меню пункт Перейти к коду.
В обработчик событий ThisDocument_Startup добавьте следующий код. В этом коде при открытии документа отображается сообщение об успешном развертывании решения.
```
MessageBox.Show("The deployment is successful")
```
```
MessageBox.Show("The deployment is successful");
```
Дополнительные сведения о событии Startup см. в разделе Инструменты Visual Studio для событий проекта Office.
Нажмите клавишу F5 для построения и выполнения проекта. Убедитесь, что появилось ожидаемое сообщение.

Развертывание решения

Теперь можно развернуть документ и сборку в новой папке на компьютере разработчика.

Развертывание решения

Создайте папку с именем TestDeploy в корневом каталоге системного диска Windows (%SystemDrive%). Например, для системного диска C это будет папка C:\TestDeploy.
Скопируйте документ и сборку из выходной папки построения проекта (как правило, папка проекта\bin\debug или папка проекта\bin\release) в папку %SystemDrive%\TestDeploy.
Откройте документ в папке %SystemDrive%\TestDeploy. Будет показано сообщение об ошибке, в котором сообщается, что текущая политика безопасности .NET не разрешает исполнение данной настройки. Это произошло потому, что сборке пока не было предоставлено полное доверие.
Нажмите кнопку ОК и закройте документ.

Настройка политики безопасности

Чтобы запустить решение, необходимо предоставить полное доверие ее сборке, настроив соответствующим образом политику безопасности платформы .NET Framework 2.0. В этом руководстве полное доверие сборке предоставляется с помощью средства настройки политики управления доступом для кода (Caspol.exe).

Дополнительные сведения о работе с Caspol.exe см. в разделах Средство настройки политики управления доступом для кода (Caspol.exe) и Настройка политики безопасности с помощью средства для настройки политики управления доступом для кода (Caspol.exe).

Примечание о безопасности.
Чтобы завершить это руководство, выполните следующие шаги по настройке политики безопасности на основе свидетельства URL-адреса. Не используйте описываемый метод для предоставления полных прав сборкам в реальных решениях, если есть сомнения в том, что их расположение надежно и безопасно. Для реальных решений рекомендуется использовать политику безопасности, основанную на более значимых, чем URL-адрес сборки, свидетельствах. Дополнительные сведения см. в разделе Требования безопасности при выполнении решений Office (для системы 2003).

Чтобы завершить это руководство, выполните следующие шаги по настройке политики безопасности на основе свидетельства URL-адреса. Не используйте описываемый метод для предоставления полных прав сборкам в реальных решениях, если есть сомнения в том, что их расположение надежно и безопасно. Для реальных решений рекомендуется использовать политику безопасности, основанную на более значимых, чем URL-адрес сборки, свидетельствах. Дополнительные сведения см. в разделе Требования безопасности при выполнении решений Office (для системы 2003).

Предоставление полного доверия сборке

Для создания новой группы кода, в которой предоставляется полное доверие сборке, введите в командной строке следующую команду: Замените full assembly path на полный путь к сборке на компьютере разработчика, например, "C:\TestDeploy\WordDeployment.dll".
```
%windir%\Microsoft.NET\Framework\v2.0.50727\caspol -u -ag All_Code -url "full assembly path" FullTrust -n "Test_Deployment"
```
Параметр -n задает имя новой группы кода. Этот параметр является необязательным и используется для упрощения идентификации и удаления новой группы кода по завершении этого пошагового руководства.
На запрос о подтверждении выполнения операции введите yes и нажмите клавишу ВВОД.
Откройте документ в папке %SystemDrive%\TestDeploy и убедитесь, что появляется ожидаемое сообщение.
Нажмите кнопку ОК и закройте документ.

Следующие действия

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