Workbook 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示 Excel 项目中的一个工作簿,这些项目通过使用 Visual Studio 中的 Office 开发工具创建。
public interface class Workbook : IDisposable, System::ComponentModel::IComponent, System::ComponentModel::ISupportInitialize, System::Windows::Forms::IBindableComponent[System.Runtime.InteropServices.Guid("b74cbb86-9c9f-4172-9ae7-3ce4a7bfa5eb")]
public interface Workbook : IDisposable, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent[<System.Runtime.InteropServices.Guid("b74cbb86-9c9f-4172-9ae7-3ce4a7bfa5eb")>]
type Workbook = interface
    interface IBindableComponent
    interface IComponent
    interface IDisposable
    interface ISupportInitializePublic Interface Workbook
Implements IBindableComponent, IComponent, IDisposable, ISupportInitialize- 属性
- 实现
注解
对象 Microsoft.Office.Tools.Excel.Workbook 提供的成员与 Microsoft.Office.Interop.Excel.Workbook Excel 主互操作程序集中的对象相同,但它添加了以下功能:
- VstoSmartTags 属性。 使用此属性可将智能标记添加到工作簿。 
- InnerObject 属性。 使用此属性获取主机项的基础 Microsoft.Office.Interop.Excel.Workbook 对象 Microsoft.Office.Tools.Excel.Workbook 。 
在应用程序级项目中,可以使用 方法以编程方式GetVstoObject创建Microsoft.Office.Tools.Excel.Workbook对象。 有关详细信息,请参阅 Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time。
在文档级项目中,通常不直接使用 Microsoft.Office.Tools.Excel.Workbook 对象。 请改用 ThisWorkbook 类以编程方式访问项目中的工作簿。 类 ThisWorkbook 从 Microsoft.Office.Tools.Excel.WorkbookBase 类派生其大部分成员。 此类将对其成员的所有调用重定向到Visual Studio Tools for Office运行时中 Microsoft.Office.Tools.Excel.Workbook 接口的内部实现。 有关详细信息,请参阅 Programming Document-Level Customizations。
注意
此接口由 Visual Studio Tools for Office Runtime 实现。 不应在代码中实现此接口。 有关更多信息,请参见 Visual Studio Tools for Office Runtime Overview。
使用情况
本文档介绍面向 .NET Framework 4 或更高版本的 Office 项目中所用的此类型的版本。 在面向 .NET Framework 3.5 的项目中,此类型可能具有不同的成员,因此本文档为此类型提供的代码示例可能并不适用。 有关在面向 .NET Framework 3.5 的项目中使用此类型的文档,请参阅 Visual Studio 2008 文档中的以下参考部分:http://go.microsoft.com/fwlink/?LinkId=160658。
属性
| AccuracyVersion | 指定特定工作表函数是否使用最新精度算法来计算其结果。 | 
| ActiveChart | 获取一个 Chart 对象,该对象表示活动图表(嵌入图表或图表工作表)。 嵌入图表在选择或激活后被视为活动的。 如果无活动图表,则此属性返回  | 
| ActiveSheet | 获取活动工作表(最上层的工作表)。 | 
| ActiveSlicer | 获取一个对象,该对象表示活动工作簿或指定工作簿中的活动切片器。 | 
| Application | 获取表示工作簿创建者的 Application。 | 
| AutoUpdateFrequency | 获取或设置自动更新共享工作簿的间隔分钟数。 | 
| AutoUpdateSaveChanges | 获取或设置一个值,该值指示每当工作簿自动更新时,是否将对共享工作簿所做的当前更改发送到其他用户。 | 
| BuiltinDocumentProperties | 获取一个 Microsoft.Office.Core.DocumentProperties 集合,该集合表示工作簿的所有内置文档属性。 | 
| CalculationVersion | 获取一个数字,该数字指示上次对工作簿进行完全重新计算的 Excel 的版本。 最右边四位是计算引擎的次版本号,其他位(左边)是 Microsoft Office Excel 的主版本。 | 
| ChangeHistoryDuration | 获取或设置在共享工作簿的更改历史记录中显示的天数。 | 
| Charts | 获取一个 Sheets 集合,该集合表示工作簿中的所有图表工作表。 | 
| CheckCompatibility | 获取或设置一个值,该值指示在保存工作簿时是否自动运行兼容性检查器。 | 
| Colors | 获取或设置工作簿的调色板中的颜色。 | 
| CommandBars | 获取一个 Microsoft.Office.Core.CommandBars 对象,该对象表示 Microsoft Office Excel 命令栏。 | 
| ConflictResolution | 获取或设置每次更新共享工作簿时解决冲突的方式。 | 
| Connections | 获取工作簿和数据源之间的连接的集合。 | 
| ConnectionsDisabled | 获取一个值,该值指示是否在工作簿中禁用外部连接或链接。 | 
| Container | 获取表示工作簿的容器应用程序的对象。 | 
| ContentTypeProperties | 获取描述工作簿中存储的元数据的属性的集合。 | 
| CreateBackup | 获取一个值,该值指示保存此文件时是否创建备份文件。 | 
| Creator | 获取在其中创建工作簿的应用程序。 | 
| CustomDocumentProperties | 获取一个 Microsoft.Office.Core.DocumentProperties 集合,该集合表示工作簿的所有自定义文档属性。 | 
| CustomViews | 获取一个 CustomViews 集合,该集合表示工作簿的所有自定义视图。 | 
| CustomXMLParts | 获取工作簿中的自定义 XML 部件的集合。 | 
| DataHost | 表示 Excel 项目中的一个工作簿,这些项目通过使用 Visual Studio 中的 Office 开发工具创建。 | 
| Date1904 | 获取或设置一个值,该值指示工作簿是否使用 1904 日期系统。 | 
| DefaultExtension | 获取此 Workbook 对象的默认扩展。 | 
| DefaultPivotTableStyle | 获取或设置 TableStyles 属性中的表样式,该样式用作工作簿中的数据透视表的默认样式。 | 
| DefaultSlicerStyle | 获取或设置 TableStyles 对象中的样式,该样式用作切片器的默认样式。 | 
| DefaultTableStyle | 获取或设置 TableStyles 属性中的表样式,该样式用作工作簿中的表的默认样式。 | 
| DisplayDrawingObjects | 获取或设置形状的显示方式。 | 
| DisplayInkComments | 获取或设置一个值,该值指示工作簿中是否显示墨迹注释。 | 
| DocumentInspectors | 获取工作簿的文档检查器模块的集合。 | 
| DocumentLibraryVersions | 获取一个 Microsoft.Office.Core.DocumentLibraryVersions 集合,该集合表示共享工作簿(启用了版本控制并存储在服务器上的文档库中)的版本集合。 | 
| DoNotPromptForConvert | 获取或设置一个值,该值指示在工作簿包含 Excel 2007 之前的 Excel 版本不支持的功能的情况下,是否提示用户转换工作簿。 | 
| EnableAutoRecover | 获取或设置一个值,该值指示 Microsoft Office Excel 是否按时间间隔保存更改后的文件(所有格式)。 | 
| EncryptionProvider | 获取或设置 Microsoft Office Excel 在加密文档时使用的算法加密提供程序的名称。 | 
| EnvelopeVisible | 获取或设置一个值,该值指示电子邮件撰写标题和信封工具栏是否都可见。 | 
| Excel4IntlMacroSheets | 获取一个 Sheets 集合,该集合表示工作簿中的所有 Microsoft Office Excel 4.0 国际宏表。 | 
| Excel4MacroSheets | 获取一个 Sheets 集合,该集合表示工作簿中的所有 Microsoft Office Excel 4.0 宏表。 | 
| Excel8CompatibilityMode | 获取一个值,该值指示工作簿是否处于兼容模式。 | 
| Extension | 获取此 Workbook 对象的自定义扩展。 | 
| FileFormat | 获取工作簿的文件格式和类型。 | 
| Final | 获取或设置一个值,该值指示工作簿是否处于最终状态。 | 
| ForceFullCalculation | 获取或设置一个值,该值指示是否强制对工作簿进行完全计算。 | 
| FullName | 获取对象的名称,包括其磁盘路径。 | 
| FullNameURLEncoded | 获取对象的名称,包括其磁盘路径。 | 
| HasPassword | 获取一个值,该值指示工作簿是否具有保护密码。 | 
| HasVBProject | 获取一个值,该值指示工作簿是否具有附加的 Microsoft Visual Basic for Applications (VBA) 项目。 | 
| HighlightChangesOnScreen | 获取或设置一个值,该值指示是否在屏幕上突出显示对共享工作簿所做的更改。 | 
| HostContext | 表示 Excel 项目中的一个工作簿,这些项目通过使用 Visual Studio 中的 Office 开发工具创建。 | 
| IconSets | 获取内置图标集的集合,这些图标集可用于对工作簿中的范围应用条件格式规则。 | 
| InactiveListBorderVisible | 获取或设置一个值,该值指示列表不活动时列表边框是否可见。 | 
| InnerObject | |
| IsAddin | 获取或设置一个值,该值指示工作簿是否作为外接程序运行。 | 
| IsInplace | 获取一个值,该值指示指定的工作簿是否正在就地编辑。 | 
| ItemProvider | 表示 Excel 项目中的一个工作簿,这些项目通过使用 Visual Studio 中的 Office 开发工具创建。 | 
| KeepChangeHistory | 获取或设置一个值,该值指示共享工作簿是否启用了更改跟踪。 | 
| ListChangesOnNewSheet | 获取或设置一个值,该值指示对共享工作簿所做的更改是否显示在单独的工作表上。 | 
| Mailer | 表示 Excel 项目中的一个工作簿,这些项目通过使用 Visual Studio 中的 Office 开发工具创建。 | 
| MultiUserEditing | 获取一个值,该值指示工作簿是否作为共享列表打开。 | 
| Name | 获取工作簿的名称。 | 
| Names | 获取一个 Names 集合,该集合表示工作簿中的所有名称(包括所有工作表特定的名称)。 | 
| Parent | 获取工作簿的父对象。 | 
| Password | 获取或设置打开工作簿时必须提供的密码。 | 
| PasswordEncryptionAlgorithm | 获取 Microsoft Office Excel 用来加密工作簿密码的算法。 | 
| PasswordEncryptionFileProperties | 获取一个值,该值指示 Microsoft Office Excel 是否对受密码保护的指定工作簿的文件属性进行加密。 | 
| PasswordEncryptionKeyLength | 获取 Microsoft Office Excel 用来加密工作簿密码的算法的密钥长度。 | 
| PasswordEncryptionProvider | 获取 Microsoft Office Excel 用来加密工作簿密码的算法加密提供程序的名称。 | 
| Path | 获取应用程序的完整路径,不包括最后的分隔符和应用程序的名称。 | 
| Permission | 获取一个 Microsoft.Office.Core.Permission 对象,该对象表示工作簿中的权限设置。 | 
| PersonalViewListSettings | 获取或设置一个值,该值指示列表的筛选器设置和排序设置是否包括在共享工作簿的用户个人视图中。 | 
| PersonalViewPrintSettings | 获取或设置一个值,该值指示打印设置是否包括在共享工作簿的用户个人视图中。 | 
| PrecisionAsDisplayed | 获取或设置一个值,该值指示是否仅使用数字所显示的精度来完成工作簿中的计算。 | 
| ProtectStructure | 获取一个值,该值指示工作簿中的表的顺序是否受保护。 | 
| ProtectWindows | 获取一个值,该值指示工作簿窗口是否受保护。 | 
| PublishObjects | 获取 PublishObjects 集合。 | 
| ReadOnly | 获取一个值,该值指示是否已用只读方式打开工作簿。 | 
| ReadOnlyRecommended | 获取或设置一个值,该值指示工作簿是否保存为建议的只读方式。 | 
| RemovePersonalInformation | 获取或设置一个值,该值指示个人信息是否可从工作簿中移除。 | 
| Research | 获取一个表示工作簿的信息检索服务的对象。 | 
| RevisionNumber | 获取工作簿作为共享列表打开期间的保存次数。 如果工作簿以独占模式打开,则此属性返回 0(零)。 | 
| Saved | 获取或设置一个值,该值指示工作簿自上次保存以来是否进行了更改。 | 
| SaveLinkValues | 获取或设置一个值,该值指示 Microsoft Office Excel 是否将外部链接值与工作簿一起保存。 | 
| ServerPolicy | 获取一个对象,该对象表示为运行 Microsoft Office SharePoint Server 的服务器上存储的工作簿指定的策略。 | 
| ServerViewableItems | 获取一个对象,该对象可用于与 Microsoft Office SharePoint Server 服务器上显示的工作簿中的已发布对象列表进行交互。 | 
| SharedWorkspace | 获取一个 Microsoft.Office.Core.SharedWorkspace,它表示工作簿所在的文档工作区。 | 
| Sheets | 获取一个 Sheets 集合,该集合表示工作簿中的所有工作表。 | 
| ShowConflictHistory | 获取或设置一个值,该值指示冲突历史记录工作表在作为共享列表打开的工作簿中是否可见。 | 
| ShowPivotChartActiveFields | 获取或设置一个值,该值指示数据透视图筛选窗格是否可见。 | 
| ShowPivotTableFieldList | 获取或设置一个值,该值指示数据透视表字段列表是否能够显示。 | 
| Signatures | 获取工作簿的数字签名的集合。 | 
| SlicerCaches | 获取与工作簿关联的 SlicerCaches 对象。 | 
| SmartDocument | 获取一个表示智能文档解决方案的设置的 Microsoft.Office.Core.SmartDocument。 | 
| Styles | 获取一个 Styles 集合,该集合表示工作簿中的所有样式。 | 
| Sync | 获取一个 Microsoft.Office.Core.Sync 对象,该对象提供对属于文档工作区的文档的方法和属性的访问。 | 
| TableStyles | 获取工作簿中使用的表样式的集合。 | 
| Tag | 获取或设置包含有关工作簿的数据的对象。 | 
| TemplateRemoveExtData | 获取或设置一个值,该值指示在将工作簿保存为模板时是否移除外部数据引用。 | 
| Theme | 获取应用于工作簿的主题。 | 
| UpdateLinks | 获取或设置一个值,该值指示工作簿用于更新嵌入的 OLE 链接的设置。 | 
| UpdateRemoteReferences | 获取或设置一个值,该值指示 Microsoft Office Excel 是否更新工作簿中的远程引用。 | 
| UserStatus | 获取一个二维数组(从 1 开始),该数组提供将工作簿打开为共享列表的每个用户的有关信息。 | 
| VBASigned | 获取一个值,该值指示工作簿的 Visual Basic for Applications 项目是否已进行了数字签名。 | 
| VBProject | 获取工作簿中的虚拟 Microsoft.Vbe.Interop.VBProject 项目。 | 
| VstoSmartTags | 获取与工作簿关联的 SmartTagCollection。 此类型或成员只适合在 2007 Microsoft Office system 项目中使用。 Office 2010 中已弃用智能标记。 | 
| WebOptions | 获取 WebOptions 集合,该集合包含工作簿级特性,在将文档保存为网页或打开网页时 Microsoft Office Excel 将使用这些特性。 | 
| Windows | 获取一个 Windows 集合,该集合表示工作簿中的所有窗口。 | 
| Worksheets | 获取一个 Sheets 集合,该集合表示工作簿中的所有工作表。 | 
| WritePassword | 获取或设置工作簿的写密码。 | 
| WriteReserved | 获取一个值,该值指示工作簿是否受写保护。 | 
| WriteReservedBy | 获取当前具有工作簿的写权限的用户名。 | 
| XmlMaps | 获取一个 XmlMaps 集合,该集合表示已添加到工作簿中的架构映射。 | 
| XmlNamespaces | 获取一个 XmlNamespaces 集合,该集合表示工作簿中包含的 XML 命名空间。 | 
方法
事件
| ActivateEvent | 在激活工作簿时发生。 | 
| AddinInstall | 在工作簿作为外接程序安装时发生。 | 
| AddinUninstall | 在工作簿作为外接程序卸载时发生。 | 
| AfterSave | 在保存工作簿后发生。 | 
| AfterXmlExport | 在 Microsoft Office Excel 保存工作簿的数据或将数据从工作簿导出到 XML 数据文件后发生。 | 
| AfterXmlImport | 在刷新现有 XML 数据连接后或将新 XML 数据导入工作簿后发生。 | 
| BeforeClose | 在关闭工作簿前发生。 如果工作簿已更改,则此事件在要求用户保存更改前发生。 | 
| BeforePrint | 在打印工作簿(或其中任何内容)前发生。 | 
| BeforeSave | 在保存工作簿前发生。 | 
| BeforeXmlExport | 在 Microsoft Office Excel 保存工作簿的数据或将数据从工作簿导出到 XML 数据文件前发生。 | 
| BeforeXmlImport | 在刷新现有 XML 数据连接前或将新 XML 数据导入工作簿前发生。 | 
| BindingContextChanged | 表示 Excel 项目中的一个工作簿,这些项目通过使用 Visual Studio 中的 Office 开发工具创建。 | 
| Deactivate | 在停用工作簿时发生。 | 
| New | 在创建新工作簿时发生。 | 
| NewChart | 在工作簿中创建新图表时发生。 | 
| NewSheet | 在工作簿中创建新工作表时发生。 | 
| Open | 在打开工作簿时发生。 | 
| PivotTableCloseConnection | 在数据透视表关闭到其数据源的连接后发生。 | 
| PivotTableOpenConnection | 在数据透视表打开到其数据源的连接后发生。 | 
| RowsetComplete | 当用户在记录集中导航或对 OLAP 数据透视表调用行集合操作时发生。 | 
| SheetActivate | 在激活任意工作表时发生。 | 
| SheetBeforeDoubleClick | 在双击任意工作表之后,默认的双击操作之前发生。 | 
| SheetBeforeRightClick | 在右击任意工作表之后,默认的右击操作之前发生。 | 
| SheetCalculate | 在重新计算任何工作表后或将任何更改的数据绘制在图表上后发生。 | 
| SheetChange | 在用户或外部链接更改任何工作表中的单元格时发生。 | 
| SheetDeactivate | 在停用任何工作表时发生。 | 
| SheetFollowHyperlink | 在单击工作簿中的任何超链接时发生。 | 
| SheetPivotTableAfterValueChange | 在对数据透视表内的单元格或单元格范围进行编辑或重新计算(针对包含公式的单元格)后发生。 | 
| SheetPivotTableBeforeAllocateChanges | 在将更改应用于数据透视表之前发生。 | 
| SheetPivotTableBeforeCommitChanges | 在针对 OLAP 数据源提交 PivotTable 的更改之前发生。 | 
| SheetPivotTableBeforeDiscardChanges | 在放弃对数据透视表的更改之前发生。 | 
| SheetPivotTableChangeSync | 在对数据透视表进行更改后发生。 | 
| SheetPivotTableUpdate | 在更新数据透视表的工作表后发生。 | 
| SheetSelectionChange | 所选内容在任何工作表上更改时发生。 如果所选内容位于图表工作表上,则不发生。 | 
| Shutdown | 在工作簿宿主项关闭时发生。 | 
| Startup | 在工作簿处于运行状态并且程序集中的所有初始化代码都已运行之后发生。 | 
| SyncEvent | 在属于文档工作区的工作表的本地副本与服务器上的副本进行同步时发生。 | 
| WindowActivate | 在激活任何工作簿窗口时发生。 | 
| WindowDeactivate | 在停用任何工作簿窗口时发生。 | 
| WindowResize | 在调整任意工作簿窗口的大小时发生。 |