Практическое руководство. Программное обновление путей к сборке манифеста приложения (система 2003)

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

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

Чтобы программным способом обновить манифест приложения, внедренный в документ, который является частью настройки на уровне документа, воспользуйтесь объектной моделью в среде выполнения Visual Studio Tools for Office.

При изменении путей к сборкам необходимо создать новый манифест приложения и заменить им манифест с устаревшими путями. В путях к сборкам можно использовать переменные среды, например %ProgramFiles% или %UserProfile%.

Необходимо вставить код для работы с объектной моделью в новом проекте (не в решении Visual Studio Tools for Office), например, в консольном приложении или проекте Windows Forms. В Visual Studio Tools for Office имеется пример, демонстрирующий создание инструмента, который можно использовать для редактирования встроенного манифеста приложения. Дополнительные сведения см. в разделе Пример использования класса ServerDocument.

Также существует другой способ обновления манифестов, связанный с изменением XML-файлов на сервере. Дополнительные сведения см. в разделе Практическое руководство. Изменение расположения настроек уровня документа (система 2003).

Примечание.

Сведения, приведенные в данном разделе, не относятся к надстройкам уровня приложения, поскольку в них не используются внедренные манифесты приложения. Чтобы изменить путь к сборке надстройки, воспользуйтесь текстовым редактором и измените манифест приложения на клиентском компьютере. Дополнительные сведения см. в разделе Манифесты приложений для решений Office (выпуск 2003 системы Microsoft Office). Дополнительные сведения о надстройках уровня приложения и настройках на уровне документа см. в разделе Архитектура настроек на уровне документа.

Изменение пути к сборкам программным способом

1. Добавьте в проект изменения объектной модели ссылку на Microsoft.VisualStudio.Tools.Office.Runtime.v9.0 (если такая ссылка отсутствует).

2. Добавьте в начало файла с кодом оператор Imports или using для среды выполнения.

   Imports Microsoft.VisualStudio.Tools.Applications.Runtime
   

   using Microsoft.VisualStudio.Tools.Applications.Runtime;
   

3. Вызовите статический метод AddCustomization класса ServerDocument и передайте необходимые аргументы. Сначала необходимо вызвать метод RemoveCustomization, чтобы удалить из документа все существующие настройки Visual Studio Tools for Office, в противном случае метод AddCustomization вызовет исключение InvalidOperationException.

   Dim solutionDocument As String = "C:\Documents\ExcelApplication.xls"
   Dim assemblyName As String = "ExcelApplication.dll"
   Dim manifestPath As String = "\\serversame\deployshare\ExcelApplication.application"
   Dim applicationVersion As String = "1.0.0.1"
   
   If ServerDocument.IsCustomized(solutionDocument) Then
       ServerDocument.RemoveCustomization(solutionDocument)
   End If
   
   ServerDocument.AddCustomization( _
       solutionDocument, assemblyName, manifestPath, _
       applicationVersion, False)
   

   string solutionDocument = @"C:\Documents\ExcelApplication.xls";
   string assemblyName = "ExcelApplication.dll";
   string manifestPath = @"\\servername\deployshare\ExcelApplication.application";
   string applicationVersion = "1.0.0.1";
   
   if (ServerDocument.IsCustomized(solutionDocument))
   {
       ServerDocument.RemoveCustomization(solutionDocument);
   }
   
   ServerDocument.AddCustomization(
       solutionDocument, assemblyName, manifestPath, 
       applicationVersion, false);
   

См. также

Задачи

Практическое руководство. Изменение пути манифеста развертывания программными средствами (система 2003)

Практическое руководство. Удаление расширений управляемого кода из документов (система 2003)

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

Манифесты приложения и развертывания в решениях Office

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

Ссылки

Манифесты приложений для решений Office (выпуск 2003 системы Microsoft Office)

Манифесты развертывания для решений Office (2003 система)