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 主互操作程序集中的对象相同，但它添加了以下功能：

在应用程序级项目中，可以使用 方法以编程方式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

在调整任意工作簿窗口的大小时发生。

适用于