通过

Worksheet 接口

  • 项目

表示使用 Visual Studio 中的 Office 开发工具创建的 Excel 项目中的工作表。

命名空间：  Microsoft.Office.Tools.Excel
程序集：  Microsoft.Office.Tools.Excel（在 Microsoft.Office.Tools.Excel.dll 中）

语法

声明
<GuidAttribute("297dc8d9-eabd-45a1-bdef-68ab67e5c3c3")> _
Public Interface Worksheet _
    Inherits IBindableComponent, IComponent, IDisposable, ISupportInitialize

[GuidAttribute("297dc8d9-eabd-45a1-bdef-68ab67e5c3c3")]
public interface Worksheet : IBindableComponent, 
    IComponent, IDisposable, ISupportInitialize

Worksheet 类型公开以下成员。

属性

  名称 说明
公共属性 _CodeName 基础结构。
公共属性 _DisplayRightToLeft 基础结构。
公共属性 Application 此属性获取一个表示 Microsoft Office Excel 应用程序的 Microsoft.Office.Interop.Excel.Application。
公共属性 AutoFilter 获取 Microsoft.Office.Interop.Excel.AutoFilter，它提供有关工作表上已筛选列表的信息（如果已启用筛选功能）。如果筛选功能关闭，则获取 nullnull 引用（在 Visual Basic 中为 Nothing）。
公共属性 AutoFilterMode 获取或设置一个值，该值指示当前是否在工作表上启用了筛选功能（即，当前是否显示了筛选器下拉箭头）。
公共属性 BindingContext 获取或设置 IBindableComponent 的货币管理器的集合。 （继承自 IBindableComponent。）
公共属性 Cells 获取一个 Range 对象，该对象表示工作表上的所有单元格（不仅仅是当前正在使用的单元格）。
公共属性 CircularReference 获取一个 Range 对象，该对象表示包含表上第一个循环引用的范围，或者，如果表上不存在循环引用，则获取 nullnull 引用（在 Visual Basic 中为 Nothing）。
公共属性 CodeName 基础结构。
公共属性 Columns 获取一个表示工作表上一个或多个列的 Range 对象。
公共属性 Comments 获取一个表示工作表的所有注释的 Microsoft.Office.Interop.Excel.Comments 集合。
公共属性 ConsolidationFunction 获取用于当前合并的函数代码。
公共属性 ConsolidationOptions 获取合并选项的三元素 Array。
公共属性 ConsolidationSources 获取字符串的 Array，这些字符串指定工作表的当前合并的源表和范围。
公共属性 Controls 获取工作表中包含的托管控件的集合。
公共属性 Creator 获取一个值，该值指示在其中创建工作表的应用程序。
公共属性 CustomProperties 获取一个 Microsoft.Office.Interop.Excel.CustomProperties 对象，该对象表示与工作表关联的标识符信息。
公共属性 DataBindings 获取此 IBindableComponent 的数据绑定对象的集合。 （继承自 IBindableComponent。）
公共属性 DataHost 基础结构。
公共属性 DefaultExtension 获取此 Worksheet 对象的默认扩展。
公共属性 DisplayAutomaticPageBreaks 基础结构。
公共属性 DisplayPageBreaks 获取或设置一个值，该值指示分页符（自动和手动）是否显示在工作表上。
公共属性 DisplayRightToLeft 获取或设置一个值，该值指示是否是从右向左，而不是从左向右显示工作表。
公共属性 EnableAutoFilter 获取或设置一个值，该值指示当打开仅限用户界面保护时是否启用“自动筛选”箭头。
公共属性 EnableCalculation 获取或设置一个值，该值指示 Microsoft Office Excel 是否在必要时自动重新计算工作表。
公共属性 EnableFormatConditionsCalculation 获取或设置一个值，该值确定条件格式是否将自动发生。
公共属性 EnableOutlining 获取或设置一个值，该值指示当打开仅限用户界面保护时是否启用大纲显示符号。
公共属性 EnablePivotTable 获取或设置一个值，该值指示当打开仅限用户界面保护时是否启用数据透视表控件及操作。
公共属性 EnableSelection 获取或设置一个值，该值指示在工作表上可以选择哪些单元格。
公共属性 Extension 获取此 Worksheet 对象的自定义扩展。
公共属性 FilterMode 获取一个值，该值指示工作表是否正在主动筛选数据。
公共属性 HostContext 基础结构。
公共属性 HPageBreaks 获取一个 Microsoft.Office.Interop.Excel.HPageBreaks 集合，该集合表示表上的水平分页符。
公共属性 Hyperlinks 获取一个 Microsoft.Office.Interop.Excel.Hyperlinks 集合，该集合表示范围或工作表的超链接。
公共属性 Index 获取工作表集合中工作表的索引号。
公共属性 InnerObject 获取一个 Microsoft.Office.Interop.Excel.Worksheet，它表示 Worksheet 的基础本机对象。
公共属性 ItemProvider 基础结构。
公共属性 ListObjects 获取工作表中 Microsoft.Office.Interop.Excel.ListObject 对象的集合。
公共属性 MailEnvelope 获取工作表的电子邮件头。
公共属性 Name 获取或设置工作表的名称。
公共属性 Names 获取一个 Microsoft.Office.Interop.Excel.Names 集合，该集合表示所有工作表特定的名称（以“WorksheetName!”前缀定义名称）。
公共属性 Next 获取表示下一个表的 Microsoft.Office.Interop.Excel.Worksheet。
公共属性 OnCalculate 基础结构。
公共属性 OnData 基础结构。
公共属性 OnDoubleClick 基础结构。
公共属性 OnEntry 基础结构。
公共属性 OnSheetActivate 基础结构。
公共属性 OnSheetDeactivate 基础结构。
公共属性 Outline 获取一个表示工作表大纲的 Microsoft.Office.Interop.Excel.Outline。
公共属性 PageSetup 获取一个 Microsoft.Office.Interop.Excel.PageSetup，其中包含工作表的页面设置的所有设置。
公共属性 Parent 获取工作表的父对象。
公共属性 Previous 获取表示上一个表的 Microsoft.Office.Interop.Excel.Worksheet。
公共属性 PrintedCommentPages 获取要为当前工作表打印的注释页的数目。此属性只能用于 Excel 2010 项目中。
公共属性 ProtectContents 获取一个值，该值指示工作表的内容（单个单元格）是否受保护。
公共属性 ProtectDrawingObjects 获取一个值，该值指示形状是否受保护。
公共属性 Protection 获取一个 Microsoft.Office.Interop.Excel.Protection 对象，该对象表示工作表的保护选项。
公共属性 ProtectionMode 获取一个值，该值指示是否打开仅限用户界面保护。
公共属性 ProtectScenarios 获取一个值，该值指示工作表方案是否受保护。
公共属性 QueryTables 获取一个 Microsoft.Office.Interop.Excel.QueryTables 集合，该集合表示工作表上的所有查询表。
公共属性 Range 获取一个 Microsoft.Office.Interop.Excel.Range 对象，该对象表示一个单元格或一定单元格范围。
公共属性 Rows 获取一个表示工作表上一个或多个行的 Range 对象。
公共属性 Scripts 获取一个 Microsoft.Office.Core.Scripts 集合，其中包含表示在将工作表另存为网页时该工作表中的脚本块或代码块的 Script 对象。
公共属性 ScrollArea 获取或设置允许滚动的范围，作为 A1 样式范围引用。
公共属性 Shapes 获取一个表示工作表上的所有形状的 Microsoft.Office.Interop.Excel.Shapes 对象。
公共属性 Site 获取或设置与 IComponent 关联的 ISite。 （继承自 IComponent。）
公共属性 SmartTags 获取一个 Microsoft.Office.Interop.Excel.SmartTags 对象，该对象表示工作表的智能标记的集合。
公共属性 Sort 获取当前工作表中经过排序的值。
公共属性 StandardHeight 获取工作表中所有行的标准（默认）高度（以磅为单位）。
公共属性 StandardWidth 获取或设置工作表中所有列的标准（默认）宽度。
公共属性 Tab 获取工作表的一个 Microsoft.Office.Interop.Excel.Tab。
公共属性 Tag 获取或设置包含有关工作表的数据的对象。
公共属性 TransitionExpEval 获取或设置一个值，该值指示 Microsoft Office Excel 是否对工作表使用 Lotus 1-2-3 表达式计算规则。
公共属性 TransitionFormEntry 获取或设置一个值，该值指示 Microsoft Office Excel 是否对工作表使用 Lotus 1-2-3 公式规则。
公共属性 Type 获取工作表类型。
公共属性 UsedRange 获取一个 Microsoft.Office.Interop.Excel.Range 对象，该对象表示在任何时候都包含值的所有单元格。
公共属性 Visible 获取或设置一个 Microsoft.Office.Interop.Excel.XlSheetVisibility 值，该值确定该对象是否可见。
公共属性 VPageBreaks 获取一个 Microsoft.Office.Interop.Excel.VPageBreaks 集合，该集合表示表上的垂直分页符。

页首

方法

  名称 说明
公共方法 _CheckSpelling 基础结构。
公共方法 _Evaluate 基础结构。
公共方法 _PasteSpecial 基础结构。
公共方法 _PrintOut 基础结构。
公共方法 _Protect 基础结构。
公共方法 _SaveAs 基础结构。
公共方法 Activate 使当前表成为活动表。
公共方法 Arcs 基础结构。
公共方法 BeginInit 用信号通知对象初始化即将开始。 （继承自 ISupportInitialize。）
公共方法 Buttons 基础结构。
公共方法 CalculateMethod 计算工作表中的公式。
公共方法 ChartObjects 获取一个对象，该对象表示工作表上的单个嵌入式图表（一个 Microsoft.Office.Interop.Excel.ChartObject）或所有嵌入式图表的集合（一个 Microsoft.Office.Interop.Excel.ChartObjects）。
公共方法 CheckBoxes 基础结构。
公共方法 CheckSpelling 检查工作表中的拼写。
公共方法 CircleInvalid 圈释工作表上的无效条目。
公共方法 ClearArrows 从工作表清除跟踪箭头。跟踪器箭头是通过使用审核功能添加的。
公共方法 ClearCircles 清除工作表中无效条目上的标识圈。
公共方法 Copy 将工作表复制到工作簿中的另一个位置。
公共方法 Delete 删除基础 Microsoft.Office.Interop.Excel.Worksheet 对象，但不删除宿主项。强烈建议不使用此方法。
公共方法 Dispose 执行与释放或重置非托管资源相关的应用程序定义的任务。 （继承自 IDisposable。）
公共方法 DrawingObjects 基础结构。
公共方法 Drawings 基础结构。
公共方法 DropDowns 基础结构。
公共方法 EndInit 用信号通知对象初始化已完成。 （继承自 ISupportInitialize。）
公共方法 Evaluate 将 Microsoft Office Excel 名称转换为对象或值。
公共方法 ExportAsFixedFormat 导出到指定格式的文件。
公共方法 get_Range 获取一个 Microsoft.Office.Interop.Excel.Range 对象，该对象表示一个单元格或一定单元格范围。请使用 Range 属性而不要使用此方法。
公共方法 GroupBoxes 基础结构。
公共方法 GroupObjects 基础结构。
公共方法 Labels 基础结构。
公共方法 Lines 基础结构。
公共方法 ListBoxes 基础结构。
公共方法 Move 将工作表移动到工作簿中的另一个位置。
公共方法 OLEObjects 获取一个对象，该对象表示工作表上的单个 OLE 对象（一个 Microsoft.Office.Interop.Excel.OLEObject）或所有 OLE 对象的集合（一个 Microsoft.Office.Interop.Excel.OLEObjects 集合）。
公共方法 OptionButtons 基础结构。
公共方法 Ovals 基础结构。
公共方法 Paste 将剪贴板的内容粘贴到工作表上。
公共方法 PasteSpecial 使用指定的格式将剪贴板的内容粘贴到工作表上。使用此方法可粘贴来自其他应用程序的数据或以特定格式粘贴数据。
公共方法 Pictures 基础结构。
公共方法 PivotTables 获取一个对象，该对象表示工作表上的单个数据透视表（一个 Microsoft.Office.Interop.Excel.PivotTable 对象）或所有数据透视表的集合（一个 Microsoft.Office.Interop.Excel.PivotTables 对象）。
公共方法 PivotTableWizard 创建一个 Microsoft.Office.Interop.Excel.PivotTable 对象。
公共方法 PrintOut 打印工作表。
公共方法 PrintOutEx 打印工作表。
公共方法 PrintPreview 显示与打印效果相同的工作表的预览。
公共方法 Protect 保护工作表使其无法修改。
公共方法 Rectangles 基础结构。
公共方法 ResetAllPageBreaks 重置指定工作表上的所有分页符。
公共方法 SaveAs 在另一个文件中保存对工作表所做的更改。
公共方法 Scenarios 获取一个对象，该对象表示工作表上的单个方案（一个 Microsoft.Office.Interop.Excel.Scenario 对象）或方案的集合（一个 Microsoft.Office.Interop.Excel.Scenarios 对象）。
公共方法 ScrollBars 基础结构。
公共方法 Select 选择工作表。
公共方法 SetBackgroundPicture 设置工作表的背景图形。
公共方法 ShowAllData 使当前经过筛选的列表的所有行可见。如果正在使用自动筛选，则此方法会将箭头更改为“所有”。
公共方法 ShowDataForm 显示与工作表关联的数据窗体。
公共方法 Spinners 基础结构。
公共方法 TextBoxes 基础结构。
公共方法 Unprotect 移除对工作表的保护。此方法在工作表不受保护时无效。
公共方法 XmlDataQuery 获取一个 Range 对象，该对象表示映射到特定 XPath 的单元格。如果指定的 XPath 未映射到工作表，或者如果映射的范围为空，则获取 nullnull 引用（在 Visual Basic 中为 Nothing）。
公共方法 XmlMapQuery 获取一个 Range 对象，该对象表示映射到特定 XPath 的单元格。如果指定的 XPath 未映射到工作表，则获取 nullnull 引用（在 Visual Basic 中为 Nothing）。

页首

事件

  名称 说明
公共事件 ActivateEvent 在激活工作表时发生。
公共事件 BeforeDoubleClick 在双击工作表之后，默认的双击操作之前发生。
公共事件 BeforeRightClick 在右击工作表之后，默认的右击操作之前发生。
公共事件 BindingContextChanged 基础结构。
公共事件 Calculate 在重新计算工作表之后发生。
公共事件 Change 在 Worksheet 单元格中的某些内容发生更改时发生。
公共事件 Deactivate 当工作表失去焦点时发生。
公共事件 Disposed 表示处理组件的 Disposed 事件的方法。 （继承自 IComponent。）
公共事件 FollowHyperlink 在单击工作表上的任意超链接时发生。
公共事件 PivotTableAfterValueChange 在对数据透视表内的单元格或单元格范围进行编辑或重新计算（针对包含公式的单元格）后发生。此事件只能用于 Excel 2010 项目中。
公共事件 PivotTableBeforeAllocateChanges 在将更改应用于数据透视表之前发生。此事件只能用于 Excel 2010 项目中。
公共事件 PivotTableBeforeCommitChanges 在针对 OLAP 数据源提交数据透视表的更改之前发生。此事件只能用于 Excel 2010 项目中。
公共事件 PivotTableBeforeDiscardChanges 在放弃对数据透视表的更改之前发生。此事件只能用于 Excel 2010 项目中。
公共事件 PivotTableChangeSync 在对数据透视表进行更改后发生。此事件只能用于 Excel 2010 项目中。
公共事件 PivotTableUpdate 在工作表上更新数据透视表之后发生。
公共事件 SelectionChange 在工作表上的所选内容发生更改时发生。
公共事件 Shutdown 在工作表宿主项关闭时发生。
公共事件 Startup 在工作表处于运行状态并且程序集中的所有初始化代码都已运行之后发生。

页首

备注

Microsoft.Office.Tools.Excel.Worksheet 对象提供和 Excel 主互操作程序集中的 Microsoft.Office.Interop.Excel.Worksheet 对象相同的成员，但它会添加以下功能：

在应用程序级项目中，可以使用 GetVstoObject 方法以编程方式创建 Microsoft.Office.Tools.Excel.Worksheet 对象。 有关更多信息，请参见 在运行时在应用程序级外接程序中扩展 Word 文档和 Excel 工作簿。

在文档级项目中，通常不要直接使用 Microsoft.Office.Tools.Excel.Worksheet 对象。 请改为使用 Sheetn 类以编程方式访问项目中的工作表。 每个 Sheetn 类从 Microsoft.Office.Tools.Excel.WorksheetBase 类派生它的大多数成员。 该类将对其成员的所有调用重定向到 Visual Studio Tools for Office Runtime中 Microsoft.Office.Tools.Excel.Worksheet 接口的内部实现。 有关更多信息，请参见 对文档级自定义项进行编程。

提示

此接口由 Visual Studio Tools for Office 运行时实现。不应在代码中实现此接口。有关更多信息，请参见 Visual Studio Tools for Office Runtime 概述。

用法

本文档介绍面向 .NET Framework 4 的 Office 项目中所用此类型的版本。在面向 .NET Framework 3.5 的项目中，此类型可能具有不同的成员，因此本文档为此类型提供的代码示例可能并不适用。有关在面向 .NET Framework 3.5 的项目中使用此类型的文档，请参见 Visual Studio 2008 文档中以下参考部分：https://go.microsoft.com/fwlink/?LinkId=160658。

请参见

参考

Microsoft.Office.Tools.Excel 命名空间

其他资源

宿主项和宿主控件概述

工作表宿主项