Workbook 接口

定义

命名空间:

Microsoft.Office.Tools.Excel

程序集:

Microsoft.Office.Tools.Excel.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

表示 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 ISupportInitialize

Public Interface Workbook
Implements IBindableComponent, IComponent, IDisposable, ISupportInitialize

属性

GuidAttribute

实现

IComponent ISupportInitialize IDisposable IBindableComponent

注解

对象 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 对象，该对象表示活动图表（嵌入图表或图表工作表）。 嵌入图表在选择或激活后被视为活动的。 如果无活动图表，则此属性返回 null。
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	获取一个 Workbook，表示 Workbook 的基础本机对象。
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 命名空间。

方法

AcceptAllChanges(Object, Object, Object)	接受共享工作簿中的所有更改。
Activate()	激活工作簿的第一个关联窗口。
AddToFavorites()	将工作簿的快捷方式添加到收藏夹文件夹。
ApplyTheme(String)	对工作簿应用指定的主题。
BreakLink(String, XlLinkType)	将链接到其他 Microsoft Office Excel 源或 OLE 源的公式转换为值。
CanCheckIn()	获取一个值，该值指示 Microsoft Office Excel 是否可以将工作簿签入到服务器。
ChangeFileAccess(XlFileAccess, Object, Object)	更改工作簿的访问权限。 这可能需要从磁盘加载更新版本。
ChangeLink(String, String, XlLinkType)	将链接从一个文档更改为另一个文档。
CheckIn(Object, Object, Object)	将本地计算机的工作簿返回到服务器，并将本地工作簿设置为只读，以使它不能进行本地编辑。 调用此方法会关闭工作簿。
CheckInWithVersion(Object, Object, Object, Object)	将本地计算机中的工作簿发送到服务器，并将本地工作簿设置为只读，以使它不能进行本地编辑。 调用此方法会关闭工作簿。
Close(Object, Object, Object)	关闭工作簿。
DeleteNumberFormat(String)	从工作簿中删除自定义数字格式。
EnableConnections()	启用工作簿内的数据连接。
EndReview()	使用 SendForReview(Object, Object, Object, Object) 方法终止对发送审阅的文件的审阅。
ExclusiveAccess()	向当前用户分配作为共享列表打开的工作簿的独占访问权限。
ExportAsFixedFormat(XlFixedFormatType, Object, Object, Object, Object, Object, Object, Object, Object)	以 PDF 或 XPS 格式保存工作簿。
FollowHyperlink(String, Object, Object, Object, Object, Object, Object)	如果文档已下载，则显示缓存文档。 否则，此方法解析超链接，下载目标文档并在适当的应用程序中显示此文档。
ForwardMailer()	表示 Excel 项目中的一个工作簿，这些项目通过使用 Visual Studio 中的 Office 开发工具创建。
GetWorkflowTasks()	返回工作簿的工作流任务的集合。
GetWorkflowTemplates()	返回工作簿的工作流模板的集合。
HighlightChangesOptions(Object, Object, Object)	控制在共享工作簿中显示更改的方式。
LinkInfo(String, XlLinkInfo, Object, Object)	获取链接日期和更新状态。
LinkSources(Object)	返回工作簿中的链接的 Array。
LockServerFile()	锁定服务器上的工作簿以防止修改。
MergeWorkbook(Object)	将更改从一个工作簿合并到一个打开的共享工作簿中。
NewWindow()	创建一个新窗口。
OpenLinks(String, Object, Object)	打开一个或多个链接的支持文档。
PivotCaches()	获取一个 PivotCaches 集合，该集合表示指定工作簿中的所有数据透视表缓存。
Post(Object)	将工作簿发送到公共文件夹。 此方法仅用于连接到 Microsoft Exchange 服务器的 Microsoft Exchange 客户端。
PrintOutEx(Object, Object, Object, Object, Object, Object, Object, Object, Object)	打印工作簿。
PrintPreview(Object)	显示与打印效果相同的对象的预览。
Protect(Object, Object, Object)	保护工作簿使其无法修改。
ProtectSharingEx(Object, Object, Object, Object, Object, Object, Object)	保存工作簿，并进行共享保护。
PurgeChangeHistoryNow(Int32, Object)	从工作簿的更改日志中移除项。
RefreshAll()	刷新工作簿中的所有外部数据范围和数据透视表。
RejectAllChanges(Object, Object, Object)	拒绝共享工作簿中的所有更改。
ReloadAs(MsoEncoding)	使用指定文档编码重新加载基于 HTML 文档的工作簿。
RemoveCustomization()	从工作簿移除使用 Visual Studio 的 Office 开发工具创建的自定义。
RemoveDocumentInformation(XlRemoveDocInfoType)	从工作簿中移除指定类型的所有信息。
RemoveUser(Int32)	从共享工作簿断开指定用户的连接。
Reply()	表示 Excel 项目中的一个工作簿，这些项目通过使用 Visual Studio 中的 Office 开发工具创建。
ReplyAll()	表示 Excel 项目中的一个工作簿，这些项目通过使用 Visual Studio 中的 Office 开发工具创建。
ReplyWithChanges(Object)	向已发送审阅的工作簿的作者发送电子邮件，通知他或她审阅者已完成对该工作簿的审阅。
ResetColors()	将调色板重置为默认颜色。
RunAutoMacros(XlRunAutoMacro)	运行附加到工作簿的 Auto_Open、Auto_Close、Auto_Activate 或 Auto_Deactivate 宏。 包含此方法是为了向后兼容。 应使用 Open、Close、Activate 和 Deactivate 事件代替这些宏。
Save()	保存对工作簿所做的更改。
SaveAs(Object, Object, Object, Object, Object, Object, XlSaveAsAccessMode, Object, Object, Object, Object, Object)	在另一个文件中保存对工作簿所做的更改。
SaveAsXMLData(String, XmlMap)	将映射到指定 XML 架构映射的数据导出到 XML 数据文件。
SaveCopyAs(Object)	将工作簿的副本保存到文件中，但不修改内存中打开的工作簿。
SendFaxOverInternet(Object, Object, Object)	将工作簿中的活动工作表作为传真发送给指定收件人。
SendForReview(Object, Object, Object, Object)	在电子邮件中将工作簿发送给指定收件人进行审阅。
SendMail(Object, Object, Object)	使用安装的邮件系统发送工作簿。
SendMailer(Object, XlPriority)	表示 Excel 项目中的一个工作簿，这些项目通过使用 Visual Studio 中的 Office 开发工具创建。
SetLinkOnData(String, Object)	设置每次更新 DDE 链接时运行的过程的名称。
SetPasswordEncryptionOptions(Object, Object, Object, Object)	设置使用密码加密工作簿的选项。
ToggleFormsDesign()	将 Microsoft Office Excel 切换进和切换出设计模式。
Unprotect(Object)	从工作簿中移除保护。 如果工作簿不受保护，则此方法无效。
UnprotectSharing(Object)	关闭共享保护并保存工作簿。
UpdateFromFile()	如果磁盘版本比内存中加载的工作簿副本更新，则从保存的工作簿磁盘版本更新只读工作簿。 如果自加载工作簿以来还未更改过磁盘副本，则不重新加载工作簿的内存副本。
UpdateLink(Object, Object)	更新 Microsoft Office Excel、DDE 或 OLE 链接（或多个链接）。
WebPagePreview()	显示与保存为网页效果相同的工作簿的预览。
XmlImport(String, XmlMap, Object, Object)	将 XML 数据文件导入当前工作簿。
XmlImportXml(String, XmlMap, Object, Object)	导入先前加载到内存中的 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	在调整任意工作簿窗口的大小时发生。