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 对象。
本节介绍以下用于返回 工作表 对象的属性：
- Worksheets 属性
- ActiveSheet 属性
Worksheets 属性
使用 “工作表 (index) ”，其中 index 是工作表索引号或名称，可返回单个 工作表 对象。
工作表索引号指示该工作表在工作簿的标签栏上的位置。 Worksheets(1) 是工作簿中第一个（最左边的）工作表，而 Worksheets(Worksheets.Count) 是最后一个。 所有工作表均包括在索引计数中，即便是隐藏工作表也是如此。
工作表名称显示在工作表的选项卡上。 使用该属性设置 Name 或返回工作表名称。
Worksheet 对象也是集合Sheets的成员。 Sheets 集合包含工作簿中的所有工作表， (图表工作表和工作表) 。
ActiveSheet 属性
当工作表为活动工作表时，可以使用 ActiveSheet 属性引用它。
属性
| 名称 | 说明 |
|---|---|
| _CodeName |
仅供内部使用。 (继承自 _Worksheet) |
| _DisplayRightToLeft |
仅供内部使用。 (继承自 _Worksheet) |
| Application |
在不使用对象限定符的情况下使用此属性时，此属性将返回表示 Application Microsoft Excel 应用程序的对象。 如果与对象识别符一起使用，则此属性返回代表指定对象的创建者的 Application 对象（可以将此属性与 OLE 自动化对象一起使用以返回该对象的应用程序）。 只读。 (继承自 _Worksheet) |
| AutoFilter |
如果筛选已启用，则返回 AutoFilter 对象。 如果筛选关闭，则 不返回任何内容 。 只读。 (继承自 _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 是从右到左而非从左到右显示的，则为 true。 如果对象从左到右显示，则为 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 |
如果工作表处于筛选模式，则为 true。 只读 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下一个工作表或单元格的 、 Range或 Worksheet 对象。 只读。 (继承自 _Worksheet) |
| OnCalculate |
仅供内部使用。 (继承自 _Worksheet) |
| OnData |
仅供内部使用。 (继承自 _Worksheet) |
| OnDoubleClick |
仅供内部使用。 (继承自 _Worksheet) |
| OnEntry |
仅供内部使用。 (继承自 _Worksheet) |
| OnSheetActivate |
仅供内部使用。 (继承自 _Worksheet) |
| OnSheetDeactivate |
仅供内部使用。 (继承自 _Worksheet) |
| Outline |
返回 Outline 表示指定工作表的大纲的对象。 只读。 (继承自 _Worksheet) |
| PageSetup |
返回包含 PageSetup 指定对象的所有页面设置设置的对象。 只读。 (继承自 _Worksheet) |
| Parent |
返回指定对象的父对象。 只读。 (继承自 _Worksheet) |
| Previous |
返回表示 Chart上一个工作表或单元格的 、 Range或 Worksheet 对象。 只读。 (继承自 _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) |