Workbook 主机项是一种类型,它从 Excel 的主互操作程序集扩展 Workbook 类型。 宿主 Workbook 项提供与对象相同的属性、方法和事件 Workbook ,但它还提供其他功能。
适用于: 本主题中的信息适用于 Excel 的文档级项目和 VSTO 外接程序项目。 有关详细信息,请参阅 Office 应用程序和项目类型提供的功能。
在文档级项目中,有一个默认 Workbook 宿主项,表示项目中的工作簿。 在 VSTO 外接程序项目中,可以在运行时生成 Workbook 主机项。
了解文档级项目中的工作簿宿主项
若要访问项目中的工作簿,请使用 ThisWorkbook 该类。 该 ThisWorkbook 类允许你访问主机项的成员 Workbook 以在自定义中执行基本任务,例如打开或关闭工作簿时运行代码。 有关详细信息,请参阅 程序文档级自定义。
该 ThisWorkbook 类提供一个位置,你可以在其中开始在项目中编写代码。 由于该类提供与 Excel 主互作程序集中的对象相同的所有属性、方法和事件 Workbook ,因此还可以用于 ThisWorkbook 访问 Excel 的对象模型。 有关详细信息,请参阅 Excel 对象模型概述。
双击解决方案资源管理器中的 ThisWorkbook 项目项以显示工作簿设计器,并在“属性”窗口中查看工作簿的属性和事件。
文档级项目中工作簿宿主项的限制
文档级项目只能包含一个 Workbook 宿主项(即 ThisWorkbook 类)。 不能在设计时向项目添加新 Workbook 宿主项,并且无法在运行时从文档级自定义项创建新的 Workbook 宿主项。
如果在运行时创建新的 Excel 工作簿,则它将是类型 Workbook。 由于它不是主机项,因此它不能包含任何主机控件或 Windows 窗体控件。 有关在运行时创建工作簿的详细信息,请参阅 如何:以编程方式创建新工作簿。
主机 Workbook 项不充当主机控件的容器。 因此,不能向工作簿添加任何可见控件,但可以添加组件,例如, DataSet以便所有工作表可以共享这些组件。 在文档级项目中,可在工具箱的“组件”选项卡、“数据”选项卡和“所有 Windows 窗体”选项卡上找到工作簿可用的组件。
注释
Visual Studio 中的 Office 开发工具不支持共享工作簿。
了解 VSTO 外接程序项目中的工作簿宿主项
在 VSTO 外接程序项目中,可以在运行时为 Excel 中打开的任何工作簿生成 Workbook 主机项。 若要生成 Workbook 宿主项,请使用 GetVstoObject 该方法。 有关详细信息,请参阅 运行时在 VSTO 外接程序中扩展 Word 文档和 Excel 工作簿。