Workbook 接口
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
代表一个 Microsoft Excel 工作簿。
public interface class Workbook : Microsoft::Office::Interop::Excel::_Workbook, Microsoft::Office::Interop::Excel::WorkbookEvents_Event[System.Runtime.InteropServices.Guid("000208DA-0000-0000-C000-000000000046")]
public interface Workbook : Microsoft.Office.Interop.Excel._Workbook, Microsoft.Office.Interop.Excel.WorkbookEvents_EventPublic Interface Workbook
Implements _Workbook, WorkbookEvents_Event- 派生
- 属性
- 实现
注解
这是派生自 COM Coclass（托管代码要求此 Coclass 来实现与相应的 COM 对象的互操作性）的 .NET 接口。 使用此派生的接口来访问所有方法、属性和 COM 对象的事件成员。 但是，如果您想要使用的方法或事件共享同一名称并且位于相同的 COM 对象下，请转换为相应的主接口以调用该方法，并转换为最新的事件接口以连接到该事件。 参考此主题以获取有关 COM 对象的信息。 有关 COM 对象的方法和属性成员的信息，请参阅 _Workbook。
对象 Workbook 是集合的 Workbooks 成员。 Workbooks 集合包含 Microsoft Excel 中当前打开的所有 Workbook 对象。
本节介绍用于返回 工作簿 对象的以下属性：
- Workbooks 属性
- ActiveWorkbook 属性
- ThisWorkbook 属性
Workbooks 属性
使用 工作簿 (index) ，其中 index 为工作簿名称或索引号）返回单个 工作簿 对象。
索引号指示在其中打开或创建工作簿的顺序。 Workbooks(1) 是创建的第一个工作簿，而 Workbooks(Workbooks.Count)Workbooks 是最后一个。 激活某工作簿并不更改其索引号。 所有工作簿均包括在索引计数中，即便是隐藏工作簿也是如此。
该 Name 属性返回工作簿名称。 不能使用此属性设置名称;如果需要更改名称，请使用该 SaveAs(Object, Object, Object, Object, Object, Object, XlSaveAsAccessMode, Object, Object, Object, Object, Object) 方法以不同的名称保存工作簿。
ActiveWorkbook 属性
ActiveWorkbook 属性返回当前处于活动状态的工作簿。
ThisWorkbook 属性
ThisWorkbook 属性返回运行 Visual Basic 代码的工作簿。 在大多数情况下，该工作簿与活动工作簿是同一个。 但是，如果 Visual Basic 代码是加载宏的组成部分，ThisWorkbook 属性就不会返回活动工作簿。 在这种情况下，活动工作簿是调用加载项的工作簿，因此 ThisWorkbook 属性返回加载项工作簿。
如果用 Visual Basic 代码创建加载宏，那么对于那些编译到加载宏中的工作簿，在其中运行的语句应当用 ThisWorkbook 属性加以限定。
属性
| 名称 | 说明 |
|---|---|
| _CodeName |
仅供内部使用。 (继承自 _Workbook) |
| _ReadOnlyRecommended |
仅供内部使用。 (继承自 _Workbook) |
| AcceptLabelsInFormulas |
如果标签可以在工作表公式中使用，则为 True。 默认值为 False。 读/写 Boolean。 (继承自 _Workbook) |
| AccuracyVersion |
获取或设置某些工作表函数是否使用最新的准确性算法来计算结果。 (继承自 _Workbook) |
| ActiveChart |
返回表示 Chart 活动图表 (嵌入图表或图表工作表) 的对象。 嵌入式图表在被选中或激活时被认为是活动的。 当没有图表处于活动状态时，此属性返回 Nothing。 只读。 (继承自 _Workbook) |
| ActiveSheet |
返回一个对象，它表示活动工作簿中或指定的窗口或工作簿中的活动工作表（顶部工作表）。 如果没有活动的工作表，则返回 Nothing。 只读。 (继承自 _Workbook) |
| ActiveSlicer |
获取一个对象，该对象表示活动工作簿或指定工作簿中的活动切片器。 (继承自 _Workbook) |
| Application |
在不使用对象限定符的情况下使用此属性时，此属性将返回表示 Application Microsoft Excel 应用程序的对象。 如果与对象识别符一起使用，则此属性返回代表指定对象的创建者的 Application 对象（可以将此属性与 OLE 自动化对象一起使用以返回该对象的应用程序）。 只读。 (继承自 _Workbook) |
| Author |
返回或设置批注的作者。 只读 String。 (继承自 _Workbook) |
| AutoUpdateFrequency |
以分钟为单位返回或设置对共享工作簿进行自动更新的时间间隔。 Integer 型，可读/写。 (继承自 _Workbook) |
| AutoUpdateSaveChanges |
如果共享工作簿自动更新时，对其所做的更改将传送到其他用户，则该值为 True。 如果不传送所做的更改（该工作簿还须与其他用户所做的更改保持同步），则该值为 False。 默认值为 True。 读/写 Boolean。 (继承自 _Workbook) |
| BuiltinDocumentProperties |
返回表示 DocumentProperties 指定工作簿的所有内置文档属性的集合。 只读。 (继承自 _Workbook) |
| CalculationVersion |
返回一个数字，其最右边的四位数字是次要计算引擎版本号，其左侧) 的其他数字 (是 Microsoft Excel 的主要版本。 对于 Workbook 对象，此属性返回有关上次完全重新计算工作簿时所用的 Excel 版本的信息。 只读 Integer。 (继承自 _Workbook) |
| CaseSensitive |
如果工作簿在比较内容时区分大小写，则为 true。 只读布 尔值 (C#) 中的 布尔 值。 (继承自 _Workbook) |
| ChangeHistoryDuration |
返回或者设置共享工作簿的修订记录中所要显示修订信息的天数。 Integer 型，可读/写。 (继承自 _Workbook) |
| ChartDataPointTrack |
如果为 true ，则当前文档中的所有图表都跟踪其所附加到的实际数据点。 False 还原回跟踪数据点的索引。 布尔值 (C#) 读/写中的布尔值。 (继承自 _Workbook) |
| Charts |
返回 Sheets 表示指定工作簿中所有图表工作表的集合。 只读。 (继承自 _Workbook) |
| CheckCompatibility |
控制在保存工作簿时是否自动运行兼容性检查器。 读/写。 (继承自 _Workbook) |
| CodeName |
返回对象的代码名。 只读 String。 在属性窗口中“名称”) 右侧单元格中看到的值是所选对象的代号 (。 可以在设计过程中通过更改该值来改变对象的代码名。 不能在运行过程中更改该属性。 (继承自 _Workbook) |
| Colors[Object] |
返回或设置工作簿调色板中的颜色。 调色板有 56 项，每项以一个 RGB 值表示。 读取/写入 对象 。 (继承自 _Workbook) |
| CommandBars |
返回 CommandBars 表示 Microsoft Excel 命令栏的对象。 只读。 (继承自 _Workbook) |
| Comments |
返回表示 Comments 指定工作表的所有注释的集合。 只读。 (继承自 _Workbook) |
| ConflictResolution |
返回或设置更新共享工作簿时解决冲突的方式。 读取/写入 XlSaveConflictResolution. (继承自 _Workbook) |
| Connections |
该 Connections 属性将在工作簿与 ODBC 或 OLEDB 数据源之间建立连接，并在不提示用户的情况下刷新数据。 只读。 (继承自 _Workbook) |
| ConnectionsDisabled |
显示工作簿中的外部连接或链接。 只读 (继承自 _Workbook) |
| Container |
返回包含指定 OLE 对象的容器应用程序的对象。 只读 对象 。 (继承自 _Workbook) |
| ContentTypeProperties |
返回 MetaProperties 描述工作簿中存储的元数据的集合。 只读。 (继承自 _Workbook) |
| CreateBackup |
如果保存文件时创建备份文件，则该属性值为 True。 只读 Boolean。 (继承自 _Workbook) |
| Creator |
返回枚举中的 XlCreator 常量，该常量指示在其中创建了此对象的应用程序。 如果该对象是在 Microsoft Excel 中创建的，则此属性返回字符串 XCEL，它等同于十六进制的数字 5843454C。 只读 XlCreator。 (继承自 _Workbook) |
| CustomDocumentProperties |
返回或设置表示 DocumentProperties 指定工作簿的所有自定义文档属性的集合。 (继承自 _Workbook) |
| CustomViews |
返回表示 CustomViews 工作簿的所有自定义视图的集合。 (继承自 _Workbook) |
| CustomXMLParts |
返回 a. CustomXMLParts 表示 XML 数据存储中自定义 XML 的集合。 只读。 (继承自 _Workbook) |
| Date1904 |
如果工作簿使用 1904 年日期系统，则为 True。 读/写 Boolean。 (继承自 _Workbook) |
| DefaultPivotTableStyle |
指定集合中 TableStyles 用作数据透视表默认样式的表格样式。 读/写。 (继承自 _Workbook) |
| DefaultSlicerStyle |
从用作切片器默认样式的对象中 TableStyles 获取或设置样式。 (继承自 _Workbook) |
| DefaultTableStyle |
指定集合中 TableStyles 用作默认 TableStyle 的表格样式。 读/写 (继承自 _Workbook) |
| DefaultTimelineStyle |
工作簿默认切片器样式的名称。 C#) 中的对象 (对象。 读/写 (继承自 _Workbook) |
| DialogSheets |
仅供内部使用。 (继承自 _Workbook) |
| DisplayDrawingObjects |
返回或设置形状的显示方式。 读取/写入 XlDisplayDrawingObjects. (继承自 _Workbook) |
| DisplayInkComments |
确定墨迹批注是否显示在工作簿中的 Boolean 值。 读/写 Boolean。 (继承自 _Workbook) |
| DocumentInspectors |
返回表示 DocumentInspectors 指定工作簿的文档检查器模块的集合。 只读。 (继承自 _Workbook) |
| DocumentLibraryVersions |
返回一个 DocumentLibraryVersions 集合，该集合表示已启用版本控制并存储在服务器上的文档库中的共享工作簿的版本集合。 (继承自 _Workbook) |
| DoNotPromptForConvert |
如果工作簿包含低于 short_Excel2007 的 Excel 版本不支持的功能，则返回或设置是否应提示用户转换工作簿。 读/写 (继承自 _Workbook) |
| EnableAutoRecover |
根据规定的时间间隔保存全部格式的已更改文件。 读/写 Boolean。 (继承自 _Workbook) |
| EncryptionProvider |
返回一个字符串，该 字符串 指定1st_Excel12在加密文档时使用的算法加密提供程序的名称。 读/写。 (继承自 _Workbook) |
| EnvelopeVisible |
如果显示电子邮件标题和信封工具栏，则该属性值为 True。 读/写 Boolean。 (继承自 _Workbook) |
| Excel4IntlMacroSheets |
返回表示 Sheets 指定工作簿中的所有 Microsoft Excel 4.0 国际宏工作表的集合。 只读。 (继承自 _Workbook) |
| Excel4MacroSheets |
返回表示 Sheets 指定工作簿中所有 Microsoft Excel 4.0 宏工作表的集合。 只读。 (继承自 _Workbook) |
| Excel8CompatibilityMode |
该Excel8CompatibilityMode属性为开发人员提供了一种检查工作簿是否处于兼容模式的方法。 只读 (继承自 _Workbook) |
| FileFormat |
返回工作簿的文件格式和/或类型。 只读 XlFileFormat。 (继承自 _Workbook) |
| Final |
返回或设置一个 Boolean 类型的值，该值指示工作簿是否是最终的。 读/写 (继承自 _Workbook) |
| ForceFullCalculation |
强制对工作簿进行完整计算。 读/写。 (继承自 _Workbook) |
| FullName |
返回对象的名称（以字符串表示），包括其磁盘路径。 只读 String。 (继承自 _Workbook) |
| FullNameURLEncoded |
返回一个 String 值，该值表示对象名称（包括其磁盘路径）。 只读。 (继承自 _Workbook) |
| HasMailer |
仅供内部使用。 (继承自 _Workbook) |
| HasPassword |
如果指定工作簿有密码保护，则该属性值为 True。 只读 Boolean。 (继承自 _Workbook) |
| HasRoutingSlip |
如果指定工作簿含有传送名单，则该属性值为 True。 读/写 Boolean。 (继承自 _Workbook) |
| HasVBProject |
返回一个 Boolean 类型的值，该值代表工作簿是否具有附加的 Microsoft Visual Basic for Applications 项目。 只读。 (继承自 _Workbook) |
| HighlightChangesOnScreen |
如果将指定共享工作簿的更改在屏幕上突出显示，则该属性值为 True。 读/写 Boolean。 (继承自 _Workbook) |
| HTMLProject |
返回HTMLProject指定工作簿中的对象，该工作簿表示顶级项目分支，如 Microsoft 脚本编辑器中的项目资源管理器中所示。 只读。 (继承自 _Workbook) |
| IconSets |
此属性用于根据集合中的单元格图标筛选工作簿中 IconSets 的数据。 只读。 (继承自 _Workbook) |
| InactiveListBorderVisible |
一个 Boolean 值，指定当列表不处于活动状态时，此列表的边框是否可见。 如果边框可见，则返回 True。 读/写 Boolean。 (继承自 _Workbook) |
| IsAddin |
如果指定工作簿作为加载宏运行，则该属性值为 True。 读/写 Boolean。 (继承自 _Workbook) |
| IsInplace |
如果指定工作簿正在适当位置上进行编辑，则该值为 True。 如果该工作簿已在 Microsoft Excel 中打开，并准备进行编辑，则该值为 False。 只读 Boolean。 (继承自 _Workbook) |
| KeepChangeHistory |
如果对共享工作簿启用了修订记录功能，则该属性值为 True。 读/写 Boolean。 (继承自 _Workbook) |
| Keywords |
仅供内部使用。 (继承自 _Workbook) |
| ListChangesOnNewSheet |
如果在单个工作表中显示共享工作簿的更改，则该属性值为 True。 读/写 Boolean。 (继承自 _Workbook) |
| Mailer |
您查询的是 Macintosh 专用的 Visual Basic 关键词。 有关该关键词的帮助信息，请查阅 Microsoft Office Macintosh 版的语言参考帮助。 (继承自 _Workbook) |
| Model |
返回顶级 Model 对象，它是工作簿的一个数据模型。 只读 (继承自 _Workbook) |
| Modules |
仅供内部使用。 (继承自 _Workbook) |
| MultiUserEditing |
如果工作簿以共享列表方式打开，则该属性值为 True。 只读 Boolean。 (继承自 _Workbook) |
| Name |
返回的对象的名称。 只读 String。 (继承自 _Workbook) |
| Names |
返回一个 Names 集合，它表示指定工作簿中的所有名称 (包括) 的所有特定于工作表的名称。 Names 对象，只读。 (继承自 _Workbook) |
| OnSave |
仅供内部使用。 (继承自 _Workbook) |
| OnSheetActivate |
仅供内部使用。 (继承自 _Workbook) |
| OnSheetDeactivate |
仅供内部使用。 (继承自 _Workbook) |
| Parent |
返回指定对象的父对象。 只读。 (继承自 _Workbook) |
| Password |
返回或设置在打开指定工作簿时必须提供的密码。 读/写 String。 (继承自 _Workbook) |
| PasswordEncryptionAlgorithm |
返回一个 String 类型的数值，该数值表示 Microsoft Excel 对指定的工作簿编写密码时使用的算法。 只读。 (继承自 _Workbook) |
| PasswordEncryptionFileProperties |
如果 Microsoft Excel 对受密码保护的指定工作簿的文件属性进行加密，则该属性值为 True。 只读 Boolean。 (继承自 _Workbook) |
| PasswordEncryptionKeyLength |
返回一个 整数 ，该整数指示 Microsoft Excel 在加密指定工作簿的密码时使用的算法的键长度。 只读。 (继承自 _Workbook) |
| PasswordEncryptionProvider |
返回一个 String 类型的数值，该数值指定在对指定工作簿加密时 Microsoft Excel 使用的算法加密提供程序的名称。 只读。 (继承自 _Workbook) |
| Path |
返回应用程序的完整路径，不包括应用程序的最终分隔符和名称。 只读 String。 (继承自 _Workbook) |
| Permission |
返回表示 Permission 指定工作簿中权限设置的对象。 (继承自 _Workbook) |
| PersonalViewListSettings |
如果在共享工作簿的用户个人视图中包括列表的筛选和排序设置，则该属性值为 True。 读/写 Boolean。 (继承自 _Workbook) |
| PersonalViewPrintSettings |
如果在共享工作簿的用户个人视图中包括打印设置，则该属性值为 True。 读写布 尔值。 (继承自 _Workbook) |
| PivotTables |
返回表示工作表上所有数据透视表报表集合的对象。 只读。 (继承自 _Workbook) |
| PrecisionAsDisplayed |
如果仅使用所显示数字的精度来完成此工作簿中的计算，则为 True。 读/写 Boolean。 (继承自 _Workbook) |
| ProtectStructure |
如果工作簿中的工作表次序处于保护状态，则该属性值为 True。 只读 Boolean。 (继承自 _Workbook) |
| ProtectWindows |
如果工作簿窗口受保护，则该属性值为 True。 只读 Boolean。 (继承自 _Workbook) |
| PublishObjects |
返回 PublishObjects 集合。 只读。 (继承自 _Workbook) |
| ReadOnly |
如果对象以只读方式打开，则返回 True。 只读 Boolean。 (继承自 _Workbook) |
| ReadOnlyRecommended |
如果工作簿以建议只读方式保存，则该属性值为 True。 只读 Boolean。 (继承自 _Workbook) |
| RemovePersonalInformation |
如果能从指定的工作簿中删除个人信息，则该值为 True。 默认值为 False。 读/写 Boolean。 (继承自 _Workbook) |
| Research |
返回 Research 表示工作簿的研究服务的对象。 只读。 (继承自 _Workbook) |
| RevisionNumber |
返回指定工作簿以共享清单方式打开后已保存的次数。 如果该工作簿以独占模式打开，则该值为 0（零）。 只读 Integer。 (继承自 _Workbook) |
| Routed |
如果工作簿已路由到下一个收件人，则为 true。 如果需要路由工作簿，则为 False。 只读 Boolean。 (继承自 _Workbook) |
| RoutingSlip |
返回表示 RoutingSlip 工作簿的路由单的对象。 如果没有路由单，则读取此属性会导致属性首次) (检查 HasRoutingSlip 错误。 只读。 (继承自 _Workbook) |
| Saved |
如果自上次保存以来未对指定工作簿进行任何更改，则为 true。 读/写 Boolean。 (继承自 _Workbook) |
| SaveLinkValues |
如果 Microsoft Excel 保存指定工作簿的外部链接值，则该属性值为 True。 读/写 Boolean。 (继承自 _Workbook) |
| ServerPolicy |
返回一个 ServerPolicy 对象，该对象表示为运行 2nd_OSS_NoVersion 2007 的服务器上存储的工作簿指定的策略。 只读。 (继承自 _Workbook) |
| ServerViewableItems |
允许开发人员与服务器上显示的工作簿中已发布对象的列表进行交互。 只读。 (继承自 _Workbook) |
| SharedWorkspace |
返回 SharedWorkspace 表示指定文档所在的文档工作区的对象。 只读。 (继承自 _Workbook) |
| Sheets |
返回 Sheets 表示指定工作簿中所有工作表的集合。 Sheets 对象，只读。 (继承自 _Workbook) |
| ShowConflictHistory |
如果“冲突的历史记录”工作表在作为共享列表打开的工作簿中可见，则该属性值为 True。 读/写 Boolean。 (继承自 _Workbook) |
| ShowPivotChartActiveFields |
此属性控制数据透视图筛选窗格的可见性。 读/写。 (继承自 _Workbook) |
| ShowPivotTableFieldList |
如果该属性值为 True（默认），则能显示数据透视表字段列表。 读/写 Boolean。 (继承自 _Workbook) |
| Signatures |
返回工作簿的数字签名。 只读。 (继承自 _Workbook) |
| SlicerCaches |
获取与工作簿关联的 SlicerCaches 对象。 (继承自 _Workbook) |
| SmartDocument |
返回表示 SmartDocument 智能文档解决方案设置的对象。 只读。 (继承自 _Workbook) |
| SmartTagOptions |
返回表示 SmartTagOptions 可以使用智能标记执行的选项的对象。 (继承自 _Workbook) |
| Styles |
返回 Styles 表示指定工作簿中所有样式的集合。 只读。 (继承自 _Workbook) |
| Subject |
仅供内部使用。 (继承自 _Workbook) |
| TableStyles |
返回 TableStyles 当前工作簿的集合对象，该对象引用当前工作簿中使用的样式。 只读。 (继承自 _Workbook) |
| TemplateRemoveExtData |
如果工作簿保存为模板时删除外部数据引用，则该属性值为 True。 读/写 Boolean。 (继承自 _Workbook) |
| Theme |
返回应用于当前工作簿的主题。 只读。 (继承自 _Workbook) |
| Title |
仅供内部使用。 (继承自 _Workbook) |
| UpdateLinks |
返回或设置一个 XlUpdateLinks 常量，该常量指示工作簿用于更新嵌入的 OLE 链接的设置。 读/写。 (继承自 _Workbook) |
| UpdateRemoteReferences |
如果 Microsoft Excel 对工作簿中的远程引用进行更新，则该值为 True。 读/写 Boolean。 (继承自 _Workbook) |
| UserControl |
仅供内部使用。 (继承自 _Workbook) |
| UserStatus |
返回一个基为 1 的二维数组，该数组提供有关每一个以共享列表模式打开工作簿的用户的信息。 数组第二维的第一个元素为用户名，第二个元素是用户打开工作簿的日期和时间，第三个元素是一个表示清单类型的数字（1 表示独占，2 表示共享）。 只读 对象 。 (继承自 _Workbook) |
| UseWholeCellCriteria |
如果工作簿使用的搜索模式与单元格的全部内容匹配，则为 True。 只读布 尔值 (C#) 中的 布尔 值。 (继承自 _Workbook) |
| UseWildcards |
如果工作簿为字符串比较和搜索启用通配符，则为 True。 只读布 尔值 (C#) 中的 布尔 值。 (继承自 _Workbook) |
| VBASigned |
如果指定工作簿的 Visual Basic for Applications 项目已经过数字签名，则该属性的值为 True。 只读 Boolean。 (继承自 _Workbook) |
| VBProject |
返回一个 VBProject 对象，该对象表示指定工作簿中的 Visual Basic 项目。 只读。 (继承自 _Workbook) |
| WebOptions |
返回集合， WebOptions 该集合包含 Microsoft Excel 在将文档另存为网页或打开网页时使用的工作簿级属性。 只读。 (继承自 _Workbook) |
| Windows |
返回表示 Windows 指定工作簿中所有窗口的集合。 Windows 对象，只读。 (继承自 _Workbook) |
| Worksheets |
返回 Sheets 表示指定工作簿中所有工作表的集合。 Sheets 对象，只读。 (继承自 _Workbook) |
| WritePassword |
为工作簿的写密码返回或设置一个 String 类型的数值。 读/写。 (继承自 _Workbook) |
| WriteReserved |
如果指定工作簿是写保护的，则该属性的值为 True。 只读 Boolean。 (继承自 _Workbook) |
| WriteReservedBy |
返回当前对指定工作簿有写权限的用户的名称。 只读 String。 (继承自 _Workbook) |
| XmlMaps |
返回表示 XmlMaps 已添加到指定工作簿的架构映射的集合。 只读。 (继承自 _Workbook) |
| XmlNamespaces |
返回表示 XmlNamespaces 指定工作簿中包含的 XML 命名空间的集合。 只读。 (继承自 _Workbook) |