Worksheet 接口
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
代表一个工作表。
public interface class Worksheet : Microsoft::Office::Interop::Excel::_Worksheet, Microsoft::Office::Interop::Excel::DocEvents_Event[System.Runtime.InteropServices.Guid("000208D8-0000-0000-C000-000000000046")]
public interface Worksheet : Microsoft.Office.Interop.Excel._Worksheet, Microsoft.Office.Interop.Excel.DocEvents_EventPublic Interface Worksheet
Implements _Worksheet, DocEvents_Event- 派生
- 属性
- 实现
注解
这是派生自 COM Coclass（托管代码要求此 Coclass 来实现与相应的 COM 对象的互操作性）的 .NET 接口。 使用此派生的接口来访问所有方法、属性和 COM 对象的事件成员。 但是，如果您想要使用的方法或事件共享同一名称并且位于相同的 COM 对象下，请转换为相应的主接口以调用该方法，并转换为最新的事件接口以连接到该事件。 参考此主题以获取有关 COM 对象的信息。 有关 COM 对象的方法和属性成员的信息，请参阅 _Worksheet。
Worksheet 对象是 集合的成员Worksheets。 Worksheets 集合包含工作簿中的所有 Worksheet 对象。
本节介绍了用于返回 Worksheet 对象的以下属性：
- Worksheets 财产
- ActiveSheet 财产
Worksheets 属性
使用 Worksheets (index) （其中 index 是工作表索引号或名称）返回单个 Worksheet 对象。
工作表索引号指示该工作表在工作簿的标签栏上的位置。 Worksheets(1) 是工作簿中第一个（最左边的）工作表，而 Worksheets(Worksheets.Count) 是最后一个。 所有工作表均包括在索引计数中，即便是隐藏工作表也是如此。
工作表名称显示在工作表的选项卡上。 Name使用 属性可设置或返回工作表名称。
Worksheet 对象也是集合的成员Sheets。 Sheets 集合包含工作簿中的所有工作表 (图表工作表和工作表) 。
ActiveSheet 属性
当工作表是活动工作表时，可以使用 ActiveSheet 属性来引用它。
属性
| _CodeName |
仅供内部使用。 (继承自 _Worksheet) |
| _DisplayRightToLeft |
仅供内部使用。 (继承自 _Worksheet) |
| Application |
在没有对象限定符的情况下使用时，此属性返回表示 Application Microsoft Excel 应用程序的 对象。 如果与对象识别符一起使用，则此属性返回代表指定对象的创建者的 Application 对象（可以将此属性与 OLE 自动化对象一起使用以返回该对象的应用程序）。 只读。 (继承自 _Worksheet) |
| AutoFilter |
如果启用筛选，则 AutoFilter 返回 对象。 如果筛选处于关闭状态，则返回 Nothing 。 此为只读属性。 (继承自 _Worksheet) |
| AutoFilterMode |
如果当前在工作表上显示有“自动筛选”下拉箭头，则该值为 True。 此属性独立于 FilterMode 属性。 读/写 Boolean。 (继承自 _Worksheet) |
| Cells |
返回一个 Range 对象，该对象表示工作表上的所有单元格 (而不仅仅是当前正在使用) 的单元格。 此为只读属性。 (继承自 _Worksheet) |
| CircularReference |
返回一个 Range 对象，该对象代表工作表上包含第一个循环引用的区域;如果工作表上没有循环引用，则返回 Nothing 。 在继续执行计算之前，必须删除循环引用。 此为只读属性。 (继承自 _Worksheet) |
| CodeName |
返回对象的代码名。 只读 String。 (继承自 _Worksheet) |
| Columns |
返回一个 Range 对象，该对象代表指定工作表上的所有列。 此为只读属性。 (继承自 _Worksheet) |
| Comments |
返回一个 Comments 集合，该集合代表指定工作表的所有注释。 此为只读属性。 (继承自 _Worksheet) |
| ConsolidationFunction |
返回当前合并计算所使用的函数代码。 可以是常量之 XlConsolidationFunction 一。 此为只读属性。 (继承自 _Worksheet) |
| ConsolidationOptions |
返回表示合并计算选项的三元素数组，如下表所示。 某元素为 True 就表示设置了该选项。 只读 对象 。 (继承自 _Worksheet) |
| ConsolidationSources |
返回一个字符串数组，这些字符串是工作表中当前合并计算的数据源的名称。 如果工作表中没有合并计算，将返回 Empty。 只读 对象 。 (继承自 _Worksheet) |
| Creator |
在枚举中 XlCreator 返回一个常量，该常量指示创建此对象的应用程序。 如果该对象是在 Microsoft Excel 中创建的，则此属性返回字符串 XCEL，它等同于十六进制的数字 5843454C。 只读 xlCreatorCode。 (继承自 _Worksheet) |
| CustomProperties |
返回一个 CustomProperties 对象，该对象表示与工作表关联的标识符信息。 (继承自 _Worksheet) |
| DisplayAutomaticPageBreaks |
仅供内部使用。 (继承自 _Worksheet) |
| DisplayPageBreaks |
如果显示指定工作表中的分页符（包括自动和手动分页符），则该属性值为 True。 读/写 Boolean。 (继承自 _Worksheet) |
| DisplayRightToLeft |
如此 如果 指定的窗口、工作表或 ListObject 从右到左而不是从左到右显示。 如果对象从左到右显示，则为 False。 只读 Boolean。 (继承自 _Worksheet) |
| EnableAutoFilter |
如果当仅限于用户界面保护处于打开状态时，启用自动筛选箭头，则该属性值为 True。 读/写 Boolean。 (继承自 _Worksheet) |
| EnableCalculation |
如果在必要的情况下 Microsoft Excel 自动重新计算工作表，则该值为 True。 如果 Excel 不重新计算工作表，则该值为 False。 读/写 Boolean。 (继承自 _Worksheet) |
| EnableFormatConditionsCalculation |
返回或设置条件格式是否将根据需要自动出现。 读/写 Boolean。 (继承自 _Worksheet) |
| EnableOutlining |
如果当仅限于用户界面保护处于打开状态时，启用分级显示符号，则该属性值为 True。 读/写 Boolean。 (继承自 _Worksheet) |
| EnablePivotTable |
如果当仅限于用户界面保护处于打开状态时，启用数据透视表控件和操作，则该属性值为 True。 读/写 Boolean。 (继承自 _Worksheet) |
| EnableSelection |
返回或设置工作表中可被选择的内容。 读/写 XlEnableSelection。 (继承自 _Worksheet) |
| FilterMode |
如此 如果 工作表处于筛选模式。 只读 Boolean。 (继承自 _Worksheet) |
| HPageBreaks |
返回一个 HPageBreaks 集合，该集合表示工作表上的水平分页符。 此为只读属性。 (继承自 _Worksheet) |
| Hyperlinks |
返回一个 Hyperlinks 集合，该集合表示区域或工作表的超链接。 (继承自 _Worksheet) |
| Index |
返回对象在其同类对象所组成的集合内的编号。 只读 Integer。 (继承自 _Worksheet) |
| ListObjects |
返回工作表中的 对象的集合 ListObject 。 ListObjects 集合，只读。 (继承自 _Worksheet) |
| MailEnvelope |
表示文档的电子邮件标题。 (继承自 _Worksheet) |
| Name |
返回或设置对象的名称。 读/写 String。 (继承自 _Worksheet) |
| Names |
返回一个 Names 集合，该集合代表所有特定于工作表的名称 (使用“WorksheetName！”前缀) 定义的名称。 Names 对象，只读。 (继承自 _Worksheet) |
| Next |
返回表示下一个Chart工作表或Worksheet单元格的 、 Range或 对象。 此为只读属性。 (继承自 _Worksheet) |
| OnCalculate |
仅供内部使用。 (继承自 _Worksheet) |
| OnData |
仅供内部使用。 (继承自 _Worksheet) |
| OnDoubleClick |
仅供内部使用。 (继承自 _Worksheet) |
| OnEntry |
仅供内部使用。 (继承自 _Worksheet) |
| OnSheetActivate |
仅供内部使用。 (继承自 _Worksheet) |
| OnSheetDeactivate |
仅供内部使用。 (继承自 _Worksheet) |
| Outline |
返回一个 Outline 对象，该对象代表指定工作表的轮廓。 此为只读属性。 (继承自 _Worksheet) |
| PageSetup |
返回一个 PageSetup 对象，该对象包含指定对象的所有页面设置设置。 此为只读属性。 (继承自 _Worksheet) |
| Parent |
返回指定对象的父对象。 只读。 (继承自 _Worksheet) |
| Previous |
返回表示上一个Chart工作表或Worksheet单元格的 、 Range或 对象。 此为只读属性。 (继承自 _Worksheet) |
| PrintedCommentPages |
获取将为当前工作表打印的注释页数。 (继承自 _Worksheet) |
| ProtectContents |
如果工作表内容是受保护的，则为 True。 对于图表，这将保护整个图表。 对于工作表，这将保护单个单元格。 只读 Boolean。 (继承自 _Worksheet) |
| ProtectDrawingObjects |
如果形状是受保护的，则为 True。 只读 Boolean。 (继承自 _Worksheet) |
| Protection |
返回一个 Protection 对象，该对象表示工作表的保护选项。 (继承自 _Worksheet) |
| ProtectionMode |
如果启用了用户界面专用保护，则为 True。 若要启用用户界面保护，请使用 Protect(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) 参数设置为 True 的方法 |
| ProtectScenarios |
如果工作表的方案处于保护状态，则该属性值为 True。 只读 Boolean。 (继承自 _Worksheet) |
| QueryTables |
返回表示 QueryTables 指定工作表上所有查询表的集合。 此为只读属性。 (继承自 _Worksheet) |
| Range[Object, Object] |
返回一个 Range 对象，该对象代表单元格或单元格区域。 (继承自 _Worksheet) |
| Rows |
返回一个 Range 对象，该对象代表指定工作表上的所有行。 此为只读 Range 对象。 (继承自 _Worksheet) |
| Scripts |
返回 Scripts 集合，该集合包含 Script 表示指定文档中脚本或代码块的对象（保存为网页时）。 (继承自 _Worksheet) |
| ScrollArea |
返回或设置允许滚动作为 A1 样式区域引用的区域。 用户不能选定滚动区域之外的单元格。 读/写 String。 (继承自 _Worksheet) |
| Shapes |
返回一个 Shapes 对象，该对象代表工作表或图表工作表上的所有形状。 此为只读属性。 (继承自 _Worksheet) |
| SmartTags |
返回一个 SmartTags 对象，该对象表示指定单元格的标识符。 (继承自 _Worksheet) |
| Sort |
在当前工作表中返回经过排序的值。 此为只读属性。 (继承自 _Worksheet) |
| StandardHeight |
返回工作表中所有行的标准 (默认) 高度（以磅为单位）。 只读 Double。 (继承自 _Worksheet) |
| StandardWidth |
返回或设置工作表中所有列的标准（默认）列宽。 读/写 Double。 (继承自 _Worksheet) |
| Tab |
返回 Tab 图表或工作表的 对象。 (继承自 _Worksheet) |
| TransitionExpEval |
如果 Microsoft Excel 对工作表使用 Lotus 1-2-3 的表达式求值规则，则该属性的值为 True。 读/写 Boolean。 (继承自 _Worksheet) |
| TransitionFormEntry |
如果 Microsoft Excel 对工作表使用 Lotus 1-2-3 的公式输入规则，则该属性的值为 True。 读/写 Boolean。 (继承自 _Worksheet) |
| Type |
返回或设置工作表类型。 只读 XlSheetType。 (继承自 _Worksheet) |
| UsedRange |
返回一个 Range 对象，该对象代表指定工作表上使用的区域。 此为只读属性。 (继承自 _Worksheet) |
| Visible |
决定对象是否可见。 读/写 XlSheetVisibility。 (继承自 _Worksheet) |
| VPageBreaks |
返回一个 VPageBreaks 集合，该集合表示工作表上的垂直分页符。 此为只读属性。 (继承自 _Worksheet) |
方法
事件
| Activate |
激活工作表时发生。 (继承自 DocEvents_Event) |
| BeforeDelete |
BeforeDelete 事件在删除任何工作表之前发生。 (继承自 DocEvents_Event) |
| BeforeDoubleClick |
当双击工作表时发生此事件，此事件先于默认的双击操作。 (继承自 DocEvents_Event) |
| BeforeRightClick |
右键单击工作表时发生此事件，此事件先于默认的右键单击操作。 (继承自 DocEvents_Event) |
| Calculate |
在重新计算工作表后发生。 (继承自 DocEvents_Event) |
| Change |
当用户更改工作表中的单元格，或外部链接引起单元格的更改时发生此事件。 (继承自 DocEvents_Event) |
| Deactivate |
在停用工作表时发生。 (继承自 DocEvents_Event) |
| FollowHyperlink |
当单击工作表上的任意超链接时，发生此事件。 有关应用程序和工作簿级别的事件，请参阅 SheetFollowHyperlink 事件。 (继承自 DocEvents_Event) |
| LensGalleryRenderComplete |
当标注库的图标 (动态和静态) 已完成呈现时发生。 (继承自 DocEvents_Event) |
| PivotTableAfterValueChange |
在编辑或重新计算（对于包含公式的单元格）数据透视表中的单元格或单元格区域后发生。 (继承自 DocEvents_Event) |
| PivotTableBeforeAllocateChanges |
在将更改应用到数据透视表前发生。 (继承自 DocEvents_Event) |
| PivotTableBeforeCommitChanges |
在向数据透视表的 OLAP 数据源提交更改之前发生。 (继承自 DocEvents_Event) |
| PivotTableBeforeDiscardChanges |
在放弃对数据透视表所做的更改之前发生。 (继承自 DocEvents_Event) |
| PivotTableChangeSync |
在更改了数据透视表之后发生。 (继承自 DocEvents_Event) |
| PivotTableUpdate |
工作簿中的数据透视表更新后发生此事件。 (继承自 DocEvents_Event) |
| SelectionChange |
当工作表上的选定区域发生改变时发生此事件。 (继承自 DocEvents_Event) |
| TableUpdate |
在工作表上更新连接到数据模型的查询表后发生。 (继承自 DocEvents_Event) |
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈