Workbook 介面

定義

代表 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
屬性
實作

備註

Microsoft.Office.Tools.Excel.Workbook物件會提供與 Microsoft.Office.Interop.Excel.Workbook Excel 主要 Interop 元件中物件相同的成員,但會新增下列功能:

在應用層級專案中,您可以使用 方法來以程序設計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

取得物件,這個物件表示現用活頁簿或指定活頁簿中的現用 Slicer。

Application

取得 Application,表示活頁簿建立者。

AutoUpdateFrequency

取得或設定共用活頁簿自動更新的間隔時間 (以分鐘為單位)。

AutoUpdateSaveChanges

取得或設定值,指出在活頁簿自動更新時,是否要將共用活頁簿的目前變更向其他使用者公佈。

BuiltinDocumentProperties

取得 Microsoft.Office.Core.DocumentProperties 集合,代表活頁簿的所有內建文件屬性。

CalculationVersion

取得版本號碼,表示前次完整重新計算活頁簿所依據的 Excel 版本。 最右邊四個數字為次要計算引擎版本號碼,而 (左邊的) 其他數字為 Microsoft Office Excel 的主要版本號碼。

ChangeHistoryDuration

取得或設定顯示在共用活頁簿歷程記錄中的天數。

Charts

取得 Sheets 集合,表示活頁簿中所有圖表工作表。

CheckCompatibility

取得或設定值,指出是否在儲存活頁簿時自動執行相容性檢查程式。

Colors

取得或設定活頁簿的調色盤 (Palette) 色彩。

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 物件中的樣式,這個物件是用來做為 Slicer 的預設樣式。

DefaultTableStyle

取得或設定 TableStyles 屬性中的表格樣式,這個屬性是用來做為活頁簿中表格的預設樣式。

DisplayDrawingObjects

取得或設定如何顯示形狀。

DisplayInkComments

取得或設定值,指出是否在活頁簿中顯示筆跡註解。

DocumentInspectors

取得活頁簿的文件檢查模組集合。

DocumentLibraryVersions

取得 Microsoft.Office.Core.DocumentLibraryVersions 集合,代表已啟用版本控制且已儲存在伺服器文件庫中的共用活頁簿版本集合。

DoNotPromptForConvert

取得或設定值,這個值表示如果活頁簿包含 Excel 2007 之前版本不支援的功能,是否要提示使用者轉換該活頁簿。

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

取得或設定值,指出是否將活頁簿當做增益集 (Add-in) 來執行。

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

取得或設定值,指出在以共用清單開啟的活頁簿中,Conflict History 工作表是否為可見。

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 Application 專案是否經過數位簽署。

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()

如果磁碟版本比載入記憶體的活頁簿複本還新,則從活頁簿的儲存磁碟版本更新唯讀活頁簿。 如果磁碟複本自載入活頁簿後就沒有變更過,則不會重新載入活頁簿的 In-Memory 複本。

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 資料來源認可變更之前發生。

SheetPivotTableBeforeDiscardChanges

在捨棄樞紐分析表的變更之前發生。

SheetPivotTableChangeSync

在變更樞紐分析表之後發生。

SheetPivotTableUpdate

在更新樞紐分析報告的工作表後發生。

SheetSelectionChange

當任何工作表的選取項目變更時發生。 如果是選取圖表則不會發生。

Shutdown

發生於活頁簿主項目關閉時。

Startup

在執行活頁簿且已執行組件中所有初始化程式碼後發生。

SyncEvent

當屬於 [文件工作區] 一部分的工作表之本機複本與伺服器上的複本同步處理時發生。

WindowActivate

當啟動任何活頁簿視窗時發生。

WindowDeactivate

當停用任何活頁簿視窗時發生。

WindowResize

在任何活頁簿視窗調整大小時發生。

適用於