“Excel 模板”项目模板

项目
08/18/2008

更新：2007 年 11 月

适用对象
本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。项目类型文档级项目 Microsoft Office 版本 Excel 2007 Excel 2003 有关更多信息，请参见按应用程序和项目类型提供的功能。

本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。

项目类型

文档级项目

Microsoft Office 版本

Excel 2007
Excel 2003

Visual Basic 和 Visual C# 中的“Excel 模板”项目模板为基于新建的或现有的 Microsoft Office Excel 模板的解决方案提供了基础。对于 Excel 2003 模板和 Excel 2007 模板，存在不同的项目模板。项目模板会自动添加必要的程序集引用、文件和生成的代码，作为解决方案的起始点。

在解决方案已经编译的情况下，如果在 Visual Studio 外部打开一个模板进行编辑，该模板将运行代码，如同已从该模板创建了一个新文档。当模板打开后开始编辑之前，则可能根据代码的不同改变该模板。若要防止代码的运行，请在打开模板时按住 Shift 键。

说明：
默认情况下，下面列表中的一些文件和引用处于隐藏状态。要查看它们，请在“解决方案资源管理器”工具栏上单击“显示所有文件”。此外，有一些文件和引用是许多 Visual Studio 项目模板所共有的，但未在下面的列表中列出。

文件

Visual Studio Tools for Office 在 Excel 2003 和 Excel 2007 模板项目中生成下面的可见文件：

工作簿名称.xls - 表示项目中的 Excel 工作簿。包含所有的工作表和图表。
Sheet1（对于 Visual Basic 为 .vb 文件，对于 Visual C# 为 .cs 文件）-- 为工作簿中第一个工作表提供设计图面和代码的工作表。有关更多信息，请参见工作表宿主项。
Sheet2（对于 Visual Basic 为 .vb 文件，对于 Visual C# 为 .cs 文件）-- 为工作簿中第二个工作表提供设计图面和代码的工作表。
Sheet3（对于 Visual Basic 为 .vb 文件，对于 Visual C# 为 .cs 文件）-- 为工作簿中第三个工作表提供设计图面和代码的工作表。
ThisWorkbook（对于 Visual Basic 为 .vb 文件，对于 Visual C# 为 .cs 文件）-- 包含用于工作簿级自定义项的设计图面和代码。有关更多信息，请参见工作簿宿主项。

说明：
不能在文档、工作簿或工作表的后台代码文件中添加其他类。您必须向项目中添加新的文件来包含您要编写的任何类。

在生成 Excel 2007 模板项目时，Visual Studio Tools for Office 还生成下面的附加文件：

项目名称_TemporaryKey.pfx — 临时证书，可用来在开发期间对项目的应用程序和部署清单进行签名。有关更多信息，请参见向 Office 解决方案授予信任 (2007 System) 和 Office 解决方案中的安全性 (2007 System)。

隐藏文件

Visual Studio Tools for Office 将生成若干隐藏文件。不要手动修改这些文件；在更改项目时会重新生成这些文件，而且不会保留手动修改。

Visual Studio Tools for Office 将生成以下隐藏文件：

ThisWorkbook.Designer.xml — 工作簿中的可编程对象的只读声明表示。
ThisWorkbook.Designer（.vb 文件或 .cs 文件）— 为工作簿中的对象提供帮助器实现的只读代码文件，其中包含用于正确实例化对象的代码。
Sheetn.Designer.xml — 工作表中可编程对象的只读声明表示。
Sheetn.Designer（.vb 文件或 .cs 文件）— 为工作表中的对象提供帮助器实现的只读代码文件，其中包含用于正确实例化对象的代码。
工作簿名称.Designer.xml — 可编程对象（如默认情况下不属于 Visual Studio Tools for Office 的自定义控件）的只读声明表示。向工作簿中的工作表添加自定义控件时，会生成此文件。
工作簿名称.Designer（.vb 文件或 .cs 文件）— 一个只读代码文件，此文件为自定义控件提供帮助器实现。向工作簿中的工作表添加自定义控件时，会生成此文件。

模板代码

项目模板代码文件中包含以下事件处理程序。有关更多信息，请参见 Visual Studio Tools for Office 项目事件。

启动事件处理程序

这些事件处理程序处理 Workbook.Startup 和 Worksheet.Startup 事件。在解决方案运行并且程序集中的所有初始化代码都已运行之后，将为每个工作表和工作簿引发这些事件。使用这些事件处理程序可以运行对解决方案进行初始化的代码。

模板解决方案中的 Startup 事件处理程序是按下面的顺序调用的：

ThisWorkbook_Startup.
Sheet1_Startup.
Sheet2_Startup.
Sheet3_Startup.
按顺序的其他工作表。

顺序是在编译项目时确定的。如果用户在运行时重新排列了工作表，并不会改变下次打开工作簿时事件的引发顺序。

关闭事件处理程序

这些事件处理程序处理 Workbook.Shutdown 和 Worksheet.Shutdown 事件。在加载有您的代码的应用程序域即将卸载时，将对每个工作表以及工作簿引发这些事件。

模板解决方案中的 Shutdown 事件处理程序是按下面的顺序调用的：

ThisWorkbook_Shutdown.
Sheet1_Shutdown.
Sheet2_Shutdown.
Sheet3_Shutdown.
按顺序的其他工作表。

引用

Visual Studio Tools for Office 在 Excel 模板项目中自动创建一组程序集引用。这些引用包括下列程序集：

Visual Studio Tools for Office 运行时中的程序集。有关这些程序集的更多信息，请参见 Visual Studio Tools for Office 运行库概述。
用于共享的 Microsoft Office 组件和用于 Excel 的主互操作程序集。有关更多信息，请参见 Office 主互操作程序集。
开发 Visual Studio Tools for Office 解决方案时使用的 .NET Framework 程序集。

请参见

通过