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

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

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

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

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

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

Файлы

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

• Имя_книги.xls — представляет книгу Excel в проекте. В нем содержатся все листы и диаграммы.

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

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

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

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

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

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

• Имя_проекта_TemporaryKey.pfx  — временный сертификат, который позволяет подписывать манифесты приложений и развертывания для проекта в процессе разработки. Дополнительные сведения см. в разделах Присвоение уровня доверия решениям Office (система 2007) и Безопасность в решениях Office (система 2007).

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

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

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

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

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

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

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

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

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

Код шаблона

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

Обработчики событий запуска

Эти обработчики обрабатывают события Workbook.Startup и Worksheet.Startup. Эти события возникают для каждого листа и для каждой книги после запуска решения и всех кодов инициализации в сборке. Эти обработчики событий позволяют запускать код инициализации решения.

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

1. ThisWorkbook_Startup.

2. Sheet1_Startup.

3. Sheet2_Startup.

4. Sheet3_Startup.

5. Другие листы по порядку.

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

Обработчики событий завершения работы

Эти обработчики обрабатывают события Workbook.Shutdown и Worksheet.Shutdown. Данные события возникают для каждого листа и для каждой книги, когда домен приложения, в который загружен код приложения, готов к выгрузке.

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

1. ThisWorkbook_Shutdown.

2. Sheet1_Shutdown.

3. Sheet2_Shutdown.

4. Sheet3_Shutdown.

5. Другие листы по порядку.

Ссылки

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

• Сборки в среде выполнения Visual Studio Tools for Office. Дополнительные сведения об этих сборках см. в разделе Общие сведения об инструментах Visual Studio для среды выполнения Office.

• Основные сборки взаимодействия для компонентов Microsoft Office с общим доступом и для компонентов Excel. Дополнительные сведения см. в разделе Основные сборки взаимодействия Office.

• Сборки .NET Framework, которые используются при разработке решений Visual Studio Tools for Office.

См. также

Задачи

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

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

Ограничения глобальных шаблонов и надстроек Excel (XLA-файлов)

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

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

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

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

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