通过

“Word 模板”项目模板

更新：2007 年 11 月

适用对象

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

项目类型

  • 文档级项目

Microsoft Office 版本

  • Word 2007

  • Word 2003

有关更多信息，请参见按应用程序和项目类型提供的功能。

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

引用托管代码扩展的 Word 模板不能被用作全局外接程序。如果从 Word 的 Startup 目录加载模板，则不会调用该程序集。有关更多信息，请参见 全局模板和 Excel 外接程序（.xla 文件）的局限性。

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

说明：

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

文件

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

  • 文档名称.dot - 表示项目中的 Word 模板。包含文档设计图面和代码文件。

  • ThisDocument（对于 Visual Basic 为 .vb 文件，对于 Visual C# 为 .cs 文件）-- 提供设计图面和代码文件的文档。有关更多信息，请参见 文档宿主项。

说明：

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

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

隐藏文件

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 Tools for Office 项目事件。

ThisDocument_Startup

ThisDocument_Startup 处理 Document.Startup 事件。此事件在解决方案已运行并且程序集中的所有初始化代码都已运行之后引发。使用此事件处理程序可以运行对解决方案进行初始化的代码。

ThisDocument_Shutdown

ThisDocument_Shutdown 处理 Document.Shutdown 事件。此事件在加载有您的代码的应用程序域即将卸载时引发。

引用

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

  • Visual Studio Tools for Office 运行时中的程序集。有关这些程序集的更多信息，请参见 Visual Studio Tools for Office 运行库概述。

  • 用于共享的 Microsoft Office 组件和用于 Word 的主互操作程序集。有关更多信息，请参见 Office 主互操作程序集。

  • 开发 Visual Studio Tools for Office 解决方案时使用的 .NET Framework 程序集。

请参见

任务

如何：创建 Visual Studio Tools for Office 项目

概念

Office 解决方案中的程序集概述

Word 对象模型概述

其他资源

管理解决方案、项目和文件

Office 项目模板