Share via


工作表宿主项

Worksheet 宿主项这种类型从 Excel 的主互操作程序集扩展 Worksheet 类型。 Worksheet 宿主项提供与 Worksheet 对象完全相同的属性、方法和事件,但它还公开其他事件并充当宿主控件和 Windows 窗体控件的容器。

适用于: 本主题中的信息适用于 Excel 的文档级项目和 VSTO 外接程序项目。 有关详细信息,请参阅办公室应用程序和项目类型提供的功能。

在文档级项目中,可以在设计时将 Worksheet 宿主项添加到项目。 在 VSTO 外接程序项目中,可以在运行时生成 Worksheet 主机项。

了解文档级项目中的工作表宿主项

为 Excel 创建文档级项目时,Visual Studio 会自动在项目中创建三个 Worksheet 宿主项。 这些工作表的默认名称分别为 Sheet1Sheet2Sheet3。 如果基于现有工作簿创建项目,则宿主项的数目取决于工作簿中工作表的数目。

利用这些工作表类,你可以访问 Worksheet 宿主项的成员,以在自定义项中执行基本任务,例如修改工作表的内容。 也可以使用这些类将控件添加到工作表。 通过组合不同的控件集并编写代码,可将控件绑定到数据、从用户处收集信息并响应用户操作。 有关详细信息,请参阅 程序文档级自定义

工作表类提供了一个位置,你可以在该位置开始编写项目中的代码。 因为该类提供与 Excel 主互操作程序集中的 Worksheet 对象完全相同的属性、方法和事件,所以也可以使用这些类访问 Excel 的对象模型。 有关详细信息,请参阅 Excel 对象模型概述

在文档级项目中,通过将新工作表添加到设计器中的工作簿,可以在设计时将其他 Worksheet 宿主项添加到项目。

重命名工作表

在文档级项目中,可在 Visual Studio 设计器中对工作表进行重命名,但此操作只会更改工作表的显示名称。 编程名称仍是工作表的默认名称。 如果在“属性” 窗口中对工作表进行重命名,则只会更改编程名称。

文档级项目中工作表宿主项的限制

在文档级项目中,不能在运行时创建新的 Worksheet 宿主项。 如果在运行时创建新的 Excel 工作表,则该工作表将为类型 Worksheet。 因为它不是宿主项,所以它不能包含任何宿主控件或 Windows 窗体控件。 有关在运行时创建文档的详细信息,请参阅 如何:以编程方式向工作簿添加新工作表。

了解 VSTO 外接程序项目中的工作表宿主项

在应用程序级项目中,可以在运行时为 Excel 中打开的任何工作表生成 Worksheet 宿主项。 可以使用 Worksheet 宿主项将控件添加到关联的工作表,或处理在 Worksheet 对象中不可用的事件。

若要生成 Worksheet 宿主项,请使用 GetVstoObject 方法。 有关详细信息,请参阅 运行时在 VSTO 外接程序中扩展 Word 文档和 Excel 工作簿。