Практическое руководство. Вложение расширений управляемого кода в документы (система 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

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

Сборку решения Visual Studio Tools for Office можно включать в существующий документ Microsoft Office Word 2003 или в книгу Microsoft Office Excel 2003. Документ или книга могут быть в любом формате, поддерживаемом Visual Studio Tools for Office. Дополнительные сведения см. в разделе Архитектура настроек на уровне документа.

Если к документу присоединяется сборка решения, которая не имеет настроек Visual Studio Tools for Office, то среда выполнения Visual Studio Tools for Office автоматически создает элемент управления-хранилище данных времени выполнения (TQC) (Runtime Storage) в документе. Дополнительные сведения см. в разделе Общие сведения о Runtime Storage Control.

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

Существует два способа включения сборки решения в документ:

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

Использование настроек в свойствах документа

Сборку решения Visual Studio Tools for Office можно включать в документ Word или Excel с помощью настройки вручную _AssemblyName и настраиваемых свойств документа _AssemblyLocation. Дополнительные сведения см. в разделе Общие сведения о настраиваемых свойствах документа.

Следующая операция предполагает, что сборка решения уже развернута и она использует манифест развертывания. Дополнительные сведения см. в разделе Развертывание настроек уровня документа (системы 2003).

Присоединение сборки решения путем задания настраиваемых свойств документа

Откройте документ в Word или Excel.
В меню Файл выберите Свойства и затем перейдите на вкладку Настройка.
Задайте свойства _AssemblyName:
1. В списке _AssemblyNameНастройки выберите _AssemblyName и тип "Звездочка" (*) в окне Значение.
2. При отсутствии в списке значения _AssemblyName задайте _AssemblyName в окне Название, выберите тип "Звездочка" (*) в окне Значение и нажмите Добавить.

Задайте свойства _AssemblyLocation:

Если _AssemblyLocation отобразится функция в списке Свойства, выберите _AssemblyLocation и в окне Значение тип полного названия пути манифеста развертывания.
При отсутствии в списке значения _AssemblyLocation в окне Название выберите _AssemblyLocation и тип полного названия пути манифеста развертывания в окне Значение, и нажмите Добавить.

Путь к месту расположения манифеста развертывания может быть указан на диске (C:\deploy\Document1.application), в общей папке () или на веб-узле (https://www.contoso.com/Document1.application).

Примечание.
Значения настроек в свойствах документа могут включать до 255 символов. Если путь к манифесту содержит больше 255 символов, создайте свойство с названием _AssemblyLocation0 и задайте в пути свойства первых 255 символов. Затем создайте свойство с названием _AssemblyLocation1 и задайте оставшиеся символы в пути к манифесту.

Значения настроек в свойствах документа могут включать до 255 символов. Если путь к манифесту содержит больше 255 символов, создайте свойство с названием _AssemblyLocation0 и задайте в пути свойства первых 255 символов. Затем создайте свойство с названием _AssemblyLocation1 и задайте оставшиеся символы в пути к манифесту.

Нажмите кнопку ОК, сохраните и закройте документ.

В последующие открытия и сохранения документа исполняющая среда Visual Studio Tools for Office включит сборку решения в документ и создаст по необходимости элемент управления-хранилище данных времени выполнения (TQC). Исполняющая среда Visual Studio Tools for Office также устанавливает для настраиваемого свойства _AssemblyLocation в документе значение GUID для элемент управления-хранилище данных времени выполнения (TQC). Дополнительные сведения см. в разделе Общие сведения о Runtime Storage Control.

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

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

Использование класса ServerDocument

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

Присоединение сборки решения к документу с помощью класса ServerDocument

Создайте новый проект Windows Forms.
Добавьте ссылку в новый проект при сборке Microsoft.VisualStudio.Tools.Applications.Runtime.dll.
Добавьте Imports или using оператор кода в верхней части файла для среды выполнения.
```
Imports Microsoft.VisualStudio.Tools.Applications.Runtime
```
```
using Microsoft.VisualStudio.Tools.Applications.Runtime;
```

Вызовите статический AddCustomization метод класса ServerDocument и укажите путь, название сборки и путь развертывания манифеста в параметре документа. Следующий код предполагает уже включенную сборку в именной документ Word WordDocument1.doc и локализованную в папке C:\WordDocument1, а также указанное расположение сборки и манифеста развертывания в сети совместного использования \\deployserver\WordDocument1\.

Private Sub AddNewCustomization()

    Dim fileName As String = "C:\WordDocument1\WordDocument1.doc"

    If Not ServerDocument.IsCustomized(fileName) Then

        Dim assemblyName As String = "\\deployserver\WordDocument1\WordDocument1.dll"
        Dim manifestPath As String = "\\deployserver\WordDocument1\WordDocument1.application"
        Dim applicationVersion As String = "1.0.0.0"

        ServerDocument.AddCustomization( _
            fileName, assemblyName, manifestPath, applicationVersion, False)

    Else
        System.Windows.Forms.MessageBox.Show( _
            "The specified document is already customized.")
    End If
End Sub

private void AddNewCustomization()
{
    string fileName = @"C:\WordDocument1\WordDocument1.doc";

    if (!ServerDocument.IsCustomized(fileName))
    {
        string assemblyName = @"\\deployserver\WordDocument1\WordDocument1.dll";
        string manifestPath = @"\\deployserver\WordDocument1\WordDocument1.application";
        string applicationVersion = "1.0.0.0";

        ServerDocument.AddCustomization(
            fileName, assemblyName, manifestPath, applicationVersion, false);
    }
    else
    {
        System.Windows.Forms.MessageBox.Show(
            "The specified document is already customized.");
    }
}

Исполняющая среда Visual Studio Tools for Office включает сборку решения в документ и создает по необходимости элемент управления-хранилище данных времени выполнения (TQC). Дополнительные сведения см. в разделе Общие сведения о Runtime Storage Control.