共用方式為

Worksheet 介面

  • 發行項

表示使用 Visual Studio 的 Office 開發工具所建立之 Excel 專案中的工作表。

命名空間：  Microsoft.Office.Tools.Excel
組件：   Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)
  Microsoft.Office.Tools.Excel.v4.0.Utilities (在 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 中)

語法

'宣告
<GuidAttribute("297dc8d9-eabd-45a1-bdef-68ab67e5c3c3")> _
Public Interface Worksheet _
    Inherits IBindableComponent, IComponent, IDisposable, ISupportInitialize

[GuidAttribute("297dc8d9-eabd-45a1-bdef-68ab67e5c3c3")]
public interface Worksheet : IBindableComponent, 
    IComponent, IDisposable, ISupportInitialize

Worksheet 型別會公開下列成員。

屬性

  名稱 說明
公用屬性 _CodeName 基礎架構。
公用屬性 _DisplayRightToLeft 基礎架構。
公用屬性 Application 這個屬性會取得 Microsoft.Office.Interop.Excel.Application，表示 Microsoft Office Excel 應用程式。
公用屬性 AutoFilter 取得 Microsoft.Office.Interop.Excel.AutoFilter，在啟用了篩選功能的情況下，提供工作表上篩選後清單的相關資訊。如果關閉篩選，則會取得 nullnull 參考 (即 Visual Basic 中的 Nothing)。
公用屬性 AutoFilterMode 取得或設定值，該值表示目前是否啟用了工作表的篩選功能 (意即目前是否顯示了篩選下拉式箭頭)。
公用屬性 BindingContext 取得或設定貨幣經理要使用的集合IBindableComponent。 (繼承自 IBindableComponent)。
公用屬性 Cells 取得 Range 物件，表示工作表上所有儲存格 (不只是目前使用中的儲存格)。
公用屬性 CircularReference 取得 Range 物件，表示包含工作表上第一個循環參考的範圍，如果工作表上沒有循環參考，則取得 nullnull 參考 (即 Visual Basic 中的 Nothing)。
公用屬性 CodeName 基礎架構。
公用屬性 Columns 取得 Range 物件，該物件表示工作表上的一個或多個欄。
公用屬性 Comments 取得 Microsoft.Office.Interop.Excel.Comments 集合，表示工作表上的所有註解。
公用屬性 ConsolidationFunction 取得用於目前彙總的函式程式碼。
公用屬性 ConsolidationOptions 取得彙總選項的三元素 Array。
公用屬性 ConsolidationSources 取得字串的 Array，這些字串是用來命名工作表目前彙總的原始工作表和範圍。
公用屬性 Controls 取得工作表上包含的 Managed 控制項集合。
公用屬性 Creator 取得值，指出建立工作表所在的應用程式。
公用屬性 CustomProperties 取得 Microsoft.Office.Interop.Excel.CustomProperties 物件，表示與工作表相關的識別項資訊。
公用屬性 DataBindings 取得資料繫結物件的集合，此IBindableComponent。 (繼承自 IBindableComponent)。
公用屬性 DataHost 基礎架構。
公用屬性 DefaultExtension 取得這個 Worksheet 物件的預設副檔名。
公用屬性 DisplayAutomaticPageBreaks 基礎架構。
公用屬性 DisplayPageBreaks 取得或設定值，指出是否在工作表上顯示分頁符號 (自動和手動)。
公用屬性 DisplayRightToLeft 取得或設定值，指出工作表是由右至左而非由左至右顯示。
公用屬性 EnableAutoFilter 取得或設定值，指出當僅使用者介面保護開啟時，是否啟用自動篩選箭號。
公用屬性 EnableCalculation 取得或設定值，指出 Microsoft Office Excel 是否會視需要自動重新計算工作表。
公用屬性 EnableFormatConditionsCalculation 取得或設定值，這個值會判斷是否自動產生條件化格式。
公用屬性 EnableOutlining 取得或設定值，指出當僅使用者介面保護開啟時，是否啟用大綱符號。
公用屬性 EnablePivotTable 取得或設定值，指出當僅使用者介面保護開啟時，是否啟用樞紐分析表控制項和動作。
公用屬性 EnableSelection 取得或設定值，指定工作表上的哪些儲存格可選取。
公用屬性 Extension 取得這個 Worksheet 物件的自訂副檔名。
公用屬性 FilterMode 取得值，該值表示工作表目前是否具備篩選資料的功能。
公用屬性 HostContext 基礎架構。
公用屬性 HPageBreaks 取得 Microsoft.Office.Interop.Excel.HPageBreaks 集合，表示工作表上的水平分頁符號。
公用屬性 Hyperlinks 取得 Microsoft.Office.Interop.Excel.Hyperlinks 集合，表示某個範圍或工作表中的超連結 (Hyperlink)。
公用屬性 Index 取得工作表集合內的工作表索引號碼。
公用屬性 InnerObject 取得 Microsoft.Office.Interop.Excel.Worksheet，表示 Worksheet 的基礎原生物件。
公用屬性 ItemProvider 基礎架構。
公用屬性 ListObjects 取得工作表中 Microsoft.Office.Interop.Excel.ListObject 物件的集合。
公用屬性 MailEnvelope 取得工作表的電子郵件標頭。
公用屬性 Name 取得或設定工作表的名稱。
公用屬性 Names 取得 Microsoft.Office.Interop.Excel.Names 集合，該集合表示所有工作表特定的名稱 (即以 "WorksheetName!" 前置詞定義的名稱)。
公用屬性 Next 取得代表下一張工作表的 Microsoft.Office.Interop.Excel.Worksheet。
公用屬性 OnCalculate 基礎架構。
公用屬性 OnData 基礎架構。
公用屬性 OnDoubleClick 基礎架構。
公用屬性 OnEntry 基礎架構。
公用屬性 OnSheetActivate 基礎架構。
公用屬性 OnSheetDeactivate 基礎架構。
公用屬性 Outline 取得 Microsoft.Office.Interop.Excel.Outline，表示工作表的大綱。
公用屬性 PageSetup 取得 Microsoft.Office.Interop.Excel.PageSetup，其中包含工作表所有版面設定的設定值。
公用屬性 Parent 取得工作表的父物件。
公用屬性 Previous 取得 Microsoft.Office.Interop.Excel.Worksheet，表示上一個的工作表。
公用屬性 PrintedCommentPages 取得將針對目前工作表列印的註解頁數。
公用屬性 ProtectContents 取得值，指出工作表的內容 (個別儲存格) 是否受到保護。
公用屬性 ProtectDrawingObjects 取得值，指出圖案是否受到保護。
公用屬性 Protection 取得 Microsoft.Office.Interop.Excel.Protection 物件，表示工作表的保護選項。
公用屬性 ProtectionMode 取得值，指出僅使用者介面保護是否開啟。
公用屬性 ProtectScenarios 取得值，指出工作表分析藍本是否受到保護。
公用屬性 QueryTables 取得 Microsoft.Office.Interop.Excel.QueryTables 集合，表示工作表上所有查詢資料表。
公用屬性 Range 取得 Microsoft.Office.Interop.Excel.Range 物件，表示某個儲存格或儲存格範圍。
公用屬性 Rows 取得 Range 物件，該物件表示工作表上的一個或多個列。
公用屬性 Scripts 取得 Microsoft.Office.Core.Scripts 集合，其中包含 Script 物件，當工作表儲存為 Web 網頁時，這些物件表示其中的指令碼或程式碼區塊。
公用屬性 ScrollArea 取得或設定允許捲動的範圍，做為 A1 樣式範圍的參照。
公用屬性 Shapes 取得 Microsoft.Office.Interop.Excel.Shapes 物件，表示工作表上所有圖案。
公用屬性 Site 取得或設定與 IComponent 相關聯的 ISite。 (繼承自 IComponent)。
公用屬性 SmartTags 取得 Microsoft.Office.Interop.Excel.SmartTags 物件，表示工作表的智慧標籤集合。
公用屬性 Sort 取得目前工作表中已排序的值。
公用屬性 StandardHeight 取得工作表中所有列的標準 (預設) 高度 (以點為單位)。
公用屬性 StandardWidth 取得或設定工作表中所有欄的標準 (預設) 寬度。
公用屬性 Tab 取得工作表的 Microsoft.Office.Interop.Excel.Tab。
公用屬性 Tag 取得或設定包含有關工作表資料的物件。
公用屬性 TransitionExpEval 取得或設定值，指出 Microsoft Office Excel 是否使用 Lotus 1-2-3 運算式評估規則計算工作表。
公用屬性 TransitionFormEntry 取得或設定值，指出 Microsoft Office Excel 是否使用 Lotus 1-2-3 公式規則計算工作表。
公用屬性 Type 取得工作表類型。
公用屬性 UsedRange 取得 Microsoft.Office.Interop.Excel.Range 物件，這個物件代表曾在任何時候含有值的所有儲存格。
公用屬性 Visible 取得或設定 Microsoft.Office.Interop.Excel.XlSheetVisibility 值，判斷是否可以看見物件。
公用屬性 VPageBreaks 取得 Microsoft.Office.Interop.Excel.VPageBreaks 集合，表示工作表上的垂直分頁符號。

回頁首

方法

  名稱 說明
公用方法 _CheckSpelling 基礎架構。
公用方法 _Evaluate 基礎架構。
公用方法 _PasteSpecial 基礎架構。
公用方法 _PrintOut 基礎架構。
公用方法 _Protect 基礎架構。
公用方法 _SaveAs 基礎架構。
公用方法 _VtblGap1_1
公用方法 _VtblGap2_1
公用方法 _VtblGap3_1
公用方法 _VtblGap4_1
公用方法 _VtblGap5_1
公用方法 _VtblGap6_1
公用方法 _VtblGap7_1
公用方法 Activate 將目前的工作表設為使用中工作表。
公用方法 Arcs 基礎架構。
公用方法 BeginInit 表示物件正在啟動初始設定。 (繼承自 ISupportInitialize)。
公用方法 Buttons 基礎架構。
公用方法 CalculateMethod 計算工作表中的公式。
公用方法 ChartObjects 取得物件，表示工作表上單一內嵌圖表 (Microsoft.Office.Interop.Excel.ChartObject) 或所有內嵌圖表的集合 (Microsoft.Office.Interop.Excel.ChartObjects)。
公用方法 CheckBoxes 基礎架構。
公用方法 CheckSpelling 檢查工作表中的拼字。
公用方法 CircleInvalid 將工作表上無效的項目圈起來。
公用方法 ClearArrows 清除工作表上的追蹤器箭號。使用稽核功能就會加入追蹤器箭號。
公用方法 ClearCircles 清除工作表上無效項目的圓圈。
公用方法 Copy 將工作表複製至活頁簿的其他位置。
公用方法 Delete 刪除基礎的 Microsoft.Office.Interop.Excel.Worksheet 物件，但不會刪除主項目。強烈建議您不要使用這個方法。
公用方法 Dispose 執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承自 IDisposable)。
公用方法 DrawingObjects 基礎架構。
公用方法 Drawings 基礎架構。
公用方法 DropDowns 基礎架構。
公用方法 EndInit 表示物件已完成初始設定。 (繼承自 ISupportInitialize)。
公用方法 Evaluate 將 Microsoft Office Excel 名稱轉換為物件或值。
公用方法 ExportAsFixedFormat 匯出成指定格式的檔案。
公用方法 get_Range 取得 Microsoft.Office.Interop.Excel.Range 物件，表示某個儲存格或儲存格範圍。請改為使用 Range 屬性，不要使用這個方法。
公用方法 GroupBoxes 基礎架構。
公用方法 GroupObjects 基礎架構。
公用方法 Labels 基礎架構。
公用方法 Lines 基礎架構。
公用方法 ListBoxes 基礎架構。
公用方法 Move 將工作表移至活頁簿的其他位置。
公用方法 OLEObjects 取得表示工作表上一個 OLE 物件 (Microsoft.Office.Interop.Excel.OLEObject) 或所有 OLE 物件集合 (Microsoft.Office.Interop.Excel.OLEObjects) 的物件。
公用方法 OptionButtons 基礎架構。
公用方法 Ovals 基礎架構。
公用方法 Paste 將剪貼簿的內容貼到工作表上。
公用方法 PasteSpecial 將剪貼簿的內容以指定格式貼至工作表中。使用這個方法可以從其他應用程式中貼上資料，或以特定格式貼上資料。
公用方法 Pictures 基礎架構。
公用方法 PivotTables 取得物件，表示工作表上的單一樞紐分析表報表 (Microsoft.Office.Interop.Excel.PivotTable 物件) 或所有樞紐分析表報表的集合 (Microsoft.Office.Interop.Excel.PivotTables 物件)。
公用方法 PivotTableWizard 建立 Microsoft.Office.Interop.Excel.PivotTable 物件。
公用方法 PrintOut 列印工作表。
公用方法 PrintOutEx 列印工作表。
公用方法 PrintPreview 顯示工作表的預覽列印。
公用方法 Protect 保護工作表，使工作表無法修改。
公用方法 Rectangles 基礎架構。
公用方法 ResetAllPageBreaks 重設指定工作表上的所有分頁符號。
公用方法 SaveAs 將工作表的變更儲存到另一個檔案中。
公用方法 Scenarios 取得物件，表示工作表上的單一分析藍本 (Microsoft.Office.Interop.Excel.Scenario 物件) 或分析藍本的集合 (Microsoft.Office.Interop.Excel.Scenarios 物件)。
公用方法 ScrollBars 基礎架構。
公用方法 Select 選取工作表。
公用方法 SetBackgroundPicture 設定工作表的背景圖形。
公用方法 ShowAllData 顯示目前過濾清單的所有列。如果目前使用自動篩選，這個方法會將箭號變更為「全部」。
公用方法 ShowDataForm 顯示與工作表相關聯的資料表單。
公用方法 Spinners 基礎架構。
公用方法 TextBoxes 基礎架構。
公用方法 Unprotect 移除工作表的保護。如果工作表未受到保護，這個方法不會有任何作用。
公用方法 XmlDataQuery 取得 Range 物件，表示對應對特定 XPath 的儲存格。如果指定的 XPath 未對應至工作表，或對應的範圍為空白時，會取得 nullnull 參考 (即 Visual Basic 中的 Nothing)。
公用方法 XmlMapQuery 取得 Range 物件，表示對應對特定 XPath 的儲存格。如果指定的 XPath 未對應至工作表，則會取得 nullnull 參考 (即 Visual Basic 中的 Nothing)。

回頁首

事件

  名稱 說明
公用事件 ActivateEvent 會在工作表啟動時發生。
公用事件 BeforeDoubleClick 會在按兩下工作表發生 (在預設按兩下動作執行之前)。
公用事件 BeforeRightClick 會在工作表上按一下滑鼠右鍵時發生 (在預設滑鼠右鍵動作執行之前)。
公用事件 BindingContextChanged 基礎架構。
公用事件 Calculate 會在重新計算工作表後發生。
公用事件 Change 會在 Worksheet 儲存格的內容改變時發生。
公用事件 Deactivate 會在工作表失去焦點時發生。
公用事件 Disposed 表示處理元件的 Disposed 事件的方法。 (繼承自 IComponent)。
公用事件 FollowHyperlink 會在按一下工作表的超連結時發生。
公用事件 PivotTableAfterValueChange 在樞紐分析表內的儲存格或儲存格範圍經過編輯或重新計算之後發生 (包含公式的儲存格)。
公用事件 PivotTableBeforeAllocateChanges 在變更套用到樞紐分析表之前發生。
公用事件 PivotTableBeforeCommitChanges 在針對樞紐分析表的 OLAP 資料來源認可變更之前發生。
公用事件 PivotTableBeforeDiscardChanges 在捨棄樞紐分析表的變更之前發生。
公用事件 PivotTableChangeSync 在變更樞紐分析表之後發生。
公用事件 PivotTableUpdate 會在工作表上的樞紐分析表報表更新時發生。
公用事件 SelectionChange 會在工作表上的選取範圍變更時發生。
公用事件 Shutdown 發生在工作表主項目關閉的時候。
公用事件 Startup 會在工作表開始執行而且組件中的所有初始化程式碼都已執行後發生。

回頁首

備註

Microsoft.Office.Tools.Excel.Worksheet 物件提供與 Excel 主要 Interop 組件中 Microsoft.Office.Interop.Excel.Worksheet 物件相同的成員，但是還加入了下列功能：

在應用程式層級專案中，您可以使用 GetVstoObject 方法，以程式設計方式建立 Microsoft.Office.Tools.Excel.Worksheet物件。如需詳細資訊，請參閱在應用程式層級增益集的執行階段中擴充 Word 文件和 Excel 活頁簿。

在文件層級專案中，您通常不會直接使用 Microsoft.Office.Tools.Excel.Worksheet 物件。請改用 Sheetn 類別，以程式設計方式存取專案中的工作表。每個 Sheetn 類別都從 Microsoft.Office.Tools.Excel.WorksheetBase 類別衍生其大多數的成員。這個類別會將其成員的所有呼叫重新導向至 Visual Studio Tools for Office Runtime 中 Microsoft.Office.Tools.Excel.Worksheet 介面的內部實作。如需詳細資訊，請參閱文件層級自訂程式設計。

注意事項注意事項

這個界面是由 Visual Studio Tools for Office Runtime 實作，並不能實作於您的程式碼中。如需詳細資訊，請參閱 Visual Studio Tools for Office Runtime 概觀。

使用方式

本文件說明此型別用於以 .NET Framework 4 和 .NET Framework 4.5 為目標之 Office 專案的版本。在以 .NET Framework 3.5 為目標的專案中，此型別可能會有不同的成員，而為此型別提供的程式碼範例可能無法運作。如需此型別在以 .NET Framework 3.5 為目標之專案中的相關文件，請參閱下列 Visual Studio 2008 文件中的參考章節：https://go.microsoft.com/fwlink/?LinkId=160658 (英文)。

請參閱

參考

Microsoft.Office.Tools.Excel 命名空間

其他資源

主項目和主控制項概觀

Worksheet 主項目