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

Шаблон проекта шаблона Word

  • Статья

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

Применимость

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

Тип проекта

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

Версия Microsoft Office

  • Word 2007

  • Word 2003

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

Шаблон проекта шаблона Word в Visual Basic или Visual C# служит основой для решений, которые разрабатываются на базе создаваемых или уже созданных шаблонов Microsoft Office Word. Существуют разные шаблоны проектов для шаблонов Word 2003 и шаблонов Word 2007. Шаблоны проектов позволяют автоматически добавлять необходимые ссылки на сборки, файлы и код, используемые в качестве отправной точки при создании решения.

Шаблоны Word, ссылающиеся на расширения управляемого кода, нельзя использовать в качестве глобальных надстроек. Если шаблон загружается из каталога Startup приложения Word, сборка не вызывается. Дополнительные сведения см. в разделе Ограничения глобальных шаблонов и надстроек Excel (XLA-файлов).

Если открыть шаблон для редактирования за пределами Visual Studio, когда компиляция решения будет завершена, шаблон начнет выполнять код точно так же, как если бы на основе шаблона был создан новый документ. В зависимости от кода уже при открытии шаблон может быть изменен, прежде чем пользователь приступит к редактированию. Чтобы предотвратить запуск кода, нажмите клавишу SHIFT и удерживайте ее, пока открывается шаблон.

0acaeh43.alert_note(ru-ru,VS.90).gifПримечание.

По умолчанию некоторые файлы и ссылки в следующем списке скрыты. Чтобы просмотреть полный список, щелкните Показать все файлы в панели инструментов обозревателя решений. В следующем списке представлены далеко не все файлы и ссылки, которые используются в шаблонах проектов Visual Studio.

Файлы

Решение Visual Studio Tools for Office создает следующие нескрытые файлы в проектах шаблонов Word 2003 и Word 2007:

  • Имя_документа.dot — представляет шаблон Word в проекте. В нем содержится файл исходного текста и рабочая область конструирования.

  • ThisDocument (VB-файл для Visual Basic или CS-файл для Visual C#) — документ, предоставляющий рабочую область конструирования и файл исходного текста. Дополнительные сведения см. в разделе Ведущий элемент документа.

0acaeh43.alert_note(ru-ru,VS.90).gifПримечание.

В файл кода, относящийся к документу, книге или листу, нельзя добавлять новые классы. Для всех дополнительных классов необходимо добавлять новые файлы.

Набор средств Visual Studio Tools for Office также дополнительно создает следующие файлы при построении шаблона проекта Word 2007:

Скрытые файлы

Решение Visual Studio Tools for Office создает несколько скрытых файлов. Не рекомендуется изменять эти файлы вручную. Они создаются повторно, когда в проект вносятся изменения, при этом изменения, сделанные вручную, не сохраняются.

Решение Visual Studio Tools for Office создает следующие скрытые файлы.

  • ThisDocument.Designer.xml — доступное только для чтения декларативное представление программируемых объектов в документе.

  • ThisDocument.Designer (VB-файл или CS-файл) — доступный только для чтения файл исходного текста, предоставляющий вспомогательные реализации для объектов в документе, в том числе и код, обеспечивающий правильное создание экземпляров объекта.

  • Имя_документа.Designer.xml — доступное только для чтения декларативное представление таких программируемых объектов, как пользовательские элементы управления, которые по умолчанию не являются частью решения Visual Studio Tools for Office. Этот файл создается при добавлении пользовательского элемента управления в документ.

  • Имя_документа.Designer (VB-файл или CS-файл) — доступный только для чтения файл исходного текста, предоставляющий вспомогательные реализации для пользовательских элементов управления. Этот файл создается при добавлении пользовательского элемента управления в документ.

Код шаблона

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

ThisDocument_Startup

ThisDocument_Startup обрабатывает событие Document.Startup. Это событие возникает после запуска решения и выполнения всех кодов инициализации в сборке. Этот обработчик событий позволяет запускать код инициализации решения.

ThisDocument_Shutdown

ThisDocument_Shutdown обрабатывает событие Document.Shutdown. Это событие возникает, когда домен приложения, в который загружен код приложения, готов к выгрузке.

Ссылки

Набор средств Visual Studio Tools for Office автоматически создает набор ссылок на сборки в шаблонах проектов Word. В этот набор входят ссылки на следующие сборки:

См. также

Задачи

Практическое руководство. Создание проектов Visual Studio Tools for Office

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

Общие сведения об использовании сборок в решениях Office

Общие сведения об объектной модели Word

Другие ресурсы

Управление решениями, проектами и файлами

Шаблоны проектов Office