Worksheet 介面

定義

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

[System.Runtime.InteropServices.Guid("297dc8d9-eabd-45a1-bdef-68ab67e5c3c3")]
public interface Worksheet : IDisposable, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent
屬性
實作

備註

Microsoft.Office.Tools.Excel.Worksheet物件會提供與 Microsoft.Office.Interop.Excel.Worksheet Excel 主要 interop 元件中的物件相同的成員,但它會加入下列功能:

在應用層級專案中,您可以 Microsoft.Office.Tools.Excel.Worksheet 使用方法,以程式設計方式建立物件 GetVstoObject 。 如需詳細資訊,請參閱 Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time

在檔層級專案中,您通常不會 Microsoft.Office.Tools.Excel.Worksheet 直接使用物件。 相反地,請使用 Sheet n類別,以程式設計方式存取專案中的工作表。 每個 Sheet n類別都會從類別衍生其大部分的成員 Microsoft.Office.Tools.Excel.WorksheetBase 。 這個類別會將其成員的所有呼叫重新導向至 Microsoft.Office.Tools.Excel.Worksheet 中介面的內部執行 Visual Studio Tools for Office Runtime 。 如需詳細資訊,請參閱 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

屬性

Application

這個屬性會取得 Application,表示 Microsoft Office Excel 應用程式。

AutoFilter

取得 AutoFilter,它提供工作表上已篩選清單的相關資訊 (如果已啟用篩選功能)。 如果已關閉篩選會取得 null

AutoFilterMode

取得或設定值,該值表示目前是否啟用了工作表的篩選功能 (意即目前是否顯示了篩選下拉式箭頭)。

Cells

取得 Range 物件,表示工作表上所有儲存格 (不只是目前使用中的儲存格)。

CircularReference

取得 Range 物件,表示包含工作表上第一個循環參考的範圍,如果工作表上沒有循環參考,則取得 null

Columns

取得 Range 物件,該物件表示工作表上的一個或多個欄。

Comments

取得 Comments 集合,表示工作表上的所有註解。

ConsolidationFunction

取得用於目前彙總的函式程式碼。

ConsolidationOptions

取得彙總選項的三元素 Array

ConsolidationSources

取得字串的 Array,這些字串是用來命名工作表目前彙總的原始工作表和範圍。

Controls

取得工作表上包含的 Managed 控制項集合。

Creator

取得值,指出建立工作表所在的應用程式。

CustomProperties

取得 CustomProperties 物件,表示與工作表相關的識別項資訊。

DataHost
DefaultExtension

取得這個 Worksheet 物件的預設延伸模組。

DisplayPageBreaks

取得或設定值,指出是否在工作表上顯示分頁符號 (自動和手動)。

DisplayRightToLeft

取得或設定值,指出工作表是由右至左而非由左至右顯示。

EnableAutoFilter

取得或設定值,指出當僅使用者介面保護開啟時,是否啟用自動篩選箭號。

EnableCalculation

取得或設定值,指出 Microsoft Office Excel 是否會視需要自動重新計算工作表。

EnableFormatConditionsCalculation

取得或設定值,這個值會判斷是否自動產生條件化格式。

EnableOutlining

取得或設定值,指出當僅使用者介面保護開啟時,是否啟用大綱符號。

EnablePivotTable

取得或設定值,指出當僅使用者介面保護開啟時,是否啟用樞紐分析表控制項和動作。

EnableSelection

取得或設定值,指定工作表上的哪些儲存格可選取。

Extension

取得這個 Worksheet 物件的自訂副檔名。

FilterMode

取得值,該值表示工作表目前是否具備篩選資料的功能。

HostContext
HPageBreaks

取得 HPageBreaks 集合,表示工作表上的水平分頁符號。

Hyperlinks

取得 Hyperlinks 集合,表示某個範圍或工作表中的超連結 (Hyperlink)。

Index

取得工作表集合內的工作表索引號碼。

InnerObject

取得 Worksheet,代表 Worksheet 的基礎原生物件。

ItemProvider
ListObjects

取得工作表中 ListObject 物件的集合。

MailEnvelope

取得工作表的電子郵件標頭。

Name

取得或設定工作表的名稱。

Names

取得 Names 集合,代表所有工作表特定的名稱 (即以 "WorksheetName!" 前置詞定義的名稱) 。

Next

取得代表下一張工作表的 Worksheet

Outline

取得 Outline,表示工作表的大綱。

PageSetup

取得 PageSetup,其中包含工作表所有版面設定的設定值。

Parent

取得工作表的父物件。

Previous

取得 Worksheet,表示上一個的工作表。

PrintedCommentPages

取得將針對目前工作表列印的註解頁數。

ProtectContents

取得值,指出工作表的內容 (個別儲存格) 是否受到保護。

ProtectDrawingObjects

取得值,指出圖案是否受到保護。

Protection

取得 Protection 物件,表示工作表的保護選項。

ProtectionMode

取得值,指出僅使用者介面保護是否開啟。

ProtectScenarios

取得值,指出工作表分析藍本是否受到保護。

QueryTables

取得 QueryTables 集合,表示工作表上所有查詢資料表。

Range

取得 Range 物件,表示某個儲存格或儲存格範圍。

Rows

取得 Range 物件,該物件表示工作表上的一個或多個列。

ScrollArea

取得或設定允許捲動的範圍,做為 A1 樣式範圍的參照。

Shapes

取得 Shapes 物件,表示工作表上所有圖案。

Sort

取得目前工作表中已排序的值。

StandardHeight

取得工作表中所有列的標準 (預設) 高度 (以點為單位)。

StandardWidth

取得或設定工作表中所有欄的標準 (預設) 寬度。

Tab

取得工作表的 Tab

Tag

取得或設定包含有關工作表資料的物件。

TransitionExpEval

取得或設定值,指出 Microsoft Office Excel 是否使用 Lotus 1-2-3 運算式評估規則計算工作表。

TransitionFormEntry

取得或設定值,指出 Microsoft Office Excel 是否使用 Lotus 1-2-3 公式規則計算工作表。

Type

取得工作表類型。

UsedRange

取得 Range 物件,這個物件代表曾在任何時候含有值的所有儲存格。

Visible

取得或設定 XlSheetVisibility 值,判斷是否可以看見物件。

VPageBreaks

取得 VPageBreaks 集合,表示工作表上的垂直分頁符號。

方法

Activate()

將目前的工作表設為使用中工作表。

CalculateMethod()

計算工作表中的公式。

ChartObjects(Object)

取得物件,表示工作表上單一內嵌圖表 (ChartObject) 或所有內嵌圖表的集合 (ChartObjects)。

CheckSpelling(Object, Object, Object, Object)

檢查工作表中的拼字。

CircleInvalid()

將工作表上無效的項目圈起來。

ClearArrows()

清除工作表上的追蹤器箭號。 使用稽核功能就會加入追蹤器箭號。

ClearCircles()

清除工作表上無效項目的圓圈。

Copy(Object, Object)

將工作表複製到活頁簿中的另一個位置。

Delete()

刪除基礎 Worksheet 物件,但不會刪除主項目。 強烈建議不要使用這個方法。

Evaluate(Object)

將 Microsoft Office Excel 名稱轉換為物件或值。

ExportAsFixedFormat(XlFixedFormatType, Object, Object, Object, Object, Object, Object, Object, Object)

匯出至所指定格式的檔案。

Move(Object, Object)

將工作表移至活頁簿的其他位置。

OLEObjects(Object)

取得表示工作表上一個 OLE 物件 (OLEObject) 或所有 OLE 物件集合 (OLEObjects) 的物件。

Paste(Object, Object)

將剪貼簿的內容貼到工作表上。

PasteSpecial(Object, Object, Object, Object, Object, Object, Object)

將剪貼簿的內容以指定格式貼至工作表中。 使用這個方法可以從其他應用程式中貼上資料,或以特定格式貼上資料。

PivotTables(Object)

取得物件,表示工作表上的單一樞紐分析表報表 (PivotTable 物件) 或所有樞紐分析表報表的集合 (PivotTables 物件)。

PivotTableWizard(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

建立 PivotTable 物件。

PrintOutEx(Object, Object, Object, Object, Object, Object, Object, Object, Object)

列印工作表。

PrintPreview(Object)

顯示工作表在列印時的預覽畫面。

Protect(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

保護工作表,使工作表無法修改。

ResetAllPageBreaks()

重設指定工作表上的所有分頁符號。

SaveAs(String, Object, Object, Object, Object, Object, Object, Object, Object, Object)

將工作表的變更儲存到另一個檔案中。

Scenarios(Object)

取得物件,表示工作表上的單一分析藍本 (Scenario 物件) 或分析藍本的集合 (Scenarios 物件)。

Select(Object)

選取工作表。

SetBackgroundPicture(String)

設定工作表的背景圖形。

ShowAllData()

顯示目前過濾清單的所有列。 如果目前使用自動篩選,這個方法會將箭號變更為「全部」。

ShowDataForm()

顯示與工作表相關聯的資料表單。

Unprotect(Object)

移除工作表的保護。 如果工作表未受到保護,這個方法不會有任何作用。

XmlDataQuery(String, Object, Object)

取得 Range 物件,表示對應對特定 XPath 的儲存格。 如果指定的 XPath 未對應至工作表,或對應的範圍為空白時,會取得 null

XmlMapQuery(String, Object, Object)

取得 Range 物件,表示對應對特定 XPath 的儲存格。 如果指定的 XPath 未對應至工作表,則會取得 null

事件

ActivateEvent

會在工作表啟動時發生。

BeforeDoubleClick

會在按兩下工作表發生 (在預設按兩下動作執行之前)。

BeforeRightClick

會在工作表上按一下滑鼠右鍵時發生 (在預設滑鼠右鍵動作執行之前)。

BindingContextChanged
Calculate

會在重新計算工作表後發生。

Change

會在 Worksheet 儲存格的內容改變時發生。

Deactivate

會在工作表失去焦點時發生。

FollowHyperlink

會在按一下工作表的超連結時發生。

PivotTableAfterValueChange

在樞紐分析表內的儲存格或儲存格範圍經過編輯或重新計算之後發生 (包含公式的儲存格)。

PivotTableBeforeAllocateChanges

在變更套用到樞紐分析表之前發生。

PivotTableBeforeCommitChanges

在針對樞紐分析表的 OLAP 資料來源認可變更之前發生。

PivotTableBeforeDiscardChanges

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

PivotTableChangeSync

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

PivotTableUpdate

會在工作表上的樞紐分析表報表更新時發生。

SelectionChange

會在工作表上的選取範圍變更時發生。

Shutdown

發生在工作表主項目關閉的時候。

Startup

會在工作表開始執行而且組件中的所有初始化程式碼都已執行後發生。

適用於