WorksheetBase 類別
提供 Microsoft Office Excel 文件層級專案中,Sheetn 類別的基底類別。
繼承階層架構
System.Object
Microsoft.Office.Tools.Excel.WorksheetBase
命名空間: Microsoft.Office.Tools.Excel
組件: Microsoft.Office.Tools.Excel.v4.0.Utilities (在 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 中)
語法
'宣告
Public MustInherit Class WorksheetBase _
Implements IWorksheetExtension, IExtension, EntryPoint, ISupportInitialize, _
IBindableComponent, IComponent, IDisposable
public abstract class WorksheetBase : IWorksheetExtension,
IExtension, EntryPoint, ISupportInitialize, IBindableComponent, IComponent,
IDisposable
WorksheetBase 型別會公開下列成員。
建構函式
名稱 | 說明 | |
---|---|---|
WorksheetBase | 基礎架構。 |
回頁首
屬性
名稱 | 說明 | |
---|---|---|
_CodeName | 基礎架構。 | |
_DisplayRightToLeft | 基礎架構。 | |
Application | 取得 Microsoft.Office.Interop.Excel.Application 物件,該物件表示 Microsoft Office Excel 應用程式。 | |
AutoFilter | 取得 Microsoft.Office.Interop.Excel.AutoFilter,在啟用了篩選功能的情況下,提供工作表上篩選後清單的相關資訊。如果關閉篩選,則會取得 nullnull 參考 (即 Visual Basic 中的 Nothing)。 | |
AutoFilterMode | 取得或設定值,該值表示目前是否啟用了工作表的篩選功能 (意即目前是否顯示了篩選下拉式箭頭)。 | |
Base | 取得這個 WorksheetBase 物件擴充的 Worksheet 物件。 | |
BindingContext | 基礎架構。 | |
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 | 基礎架構。 | |
DataHost | 基礎架構。 | |
DisplayAutomaticPageBreaks | 基礎架構。 | |
DisplayPageBreaks | 取得或設定值,指出是否在工作表上顯示分頁符號 (自動和手動)。 | |
DisplayRightToLeft | 取得或設定值,指出工作表是由右至左而非由左至右顯示。 | |
EnableAutoFilter | 取得或設定值,指出當僅使用者介面保護開啟時,是否啟用自動篩選箭號。 | |
EnableCalculation | 取得或設定值,指出 Microsoft Office Excel 是否會視需要自動重新計算工作表。 | |
EnableFormatConditionsCalculation | 取得或設定值,這個值會判斷是否自動產生條件化格式。 | |
EnableOutlining | 取得或設定值,指出當僅使用者介面保護開啟時,是否啟用大綱符號。 這個型別或成員僅適用於 2007 Microsoft Office system 專案。智慧標籤在 Office 2010 中已被取代。 . 這個型別或成員僅適用於 2007 Microsoft Office system 專案。智慧標籤在 Office 2010 中已被取代。 . |
|
EnablePivotTable | 取得或設定值,指出當僅使用者介面保護開啟時,是否啟用樞紐分析表控制項和動作。 | |
EnableSelection | 取得或設定值,指定工作表上的哪些儲存格可選取。 | |
FilterMode | 取得值,該值表示工作表目前是否具備篩選資料的功能。 | |
HostContext | 基礎架構。 | |
HPageBreaks | 取得 Microsoft.Office.Interop.Excel.HPageBreaks 集合,表示工作表上的水平分頁符號。 | |
Hyperlinks | 取得 Microsoft.Office.Interop.Excel.Hyperlinks 集合,表示某個範圍或工作表中的超連結 (Hyperlink)。 | |
Index | 取得工作表集合內的工作表索引號碼。 | |
InnerObject | 取得 Microsoft.Office.Interop.Excel.Worksheet,表示 WorksheetBase 的基礎原生物件。 | |
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 | 取得將針對目前工作表列印的註解頁數。這個屬性只能在 Excel 2010 專案中使用。 | |
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 | 基礎架構。 | |
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 集合,表示工作表上的垂直分頁符號。 |
回頁首
方法
名稱 | 說明 | |
---|---|---|
Activate | 基礎架構。 | |
Arcs | 基礎架構。 | |
BeginInit | 基礎架構。 | |
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 | 將 WorksheetBase 類別目前的執行個體所使用的資源全部釋出。 | |
DrawingObjects | 基礎架構。 | |
Drawings | 基礎架構。 | |
DropDowns | 基礎架構。 | |
EndInit | 基礎架構。 | |
Equals | 判斷指定的物件是否等於目前物件。 (繼承自 Object)。 | |
Evaluate | 將 Microsoft Office Excel 名稱轉換為物件或值。 | |
ExportAsFixedFormat | 匯出成指定格式的檔案。 | |
Finalize | 允許物件在記憶體回收進行回收之前,嘗試釋放資源並執行其他清除作業。 (繼承自 Object)。 | |
FinishInitialization | 基礎架構。 | |
get_Range | 取得 Microsoft.Office.Interop.Excel.Range 物件,表示某個儲存格或儲存格範圍。請改為使用 Range 屬性,不要使用這個方法。 | |
GetAutomationObject | 由 Visual Studio Tools for Office Runtime 呼叫,以取得工作表中 VBA 程式碼可以使用的物件。 | |
GetHashCode | 做為特定型別的雜湊函式。 (繼承自 Object)。 | |
GetType | 取得目前執行個體的 Type。 (繼承自 Object)。 | |
GroupBoxes | 基礎架構。 | |
GroupObjects | 基礎架構。 | |
Initialize | 基礎架構。 | |
InitializeDataBindings | 基礎架構。 | |
Labels | 基礎架構。 | |
Lines | 基礎架構。 | |
ListBoxes | 基礎架構。 | |
MemberwiseClone | 建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。 | |
Move | 將工作表移至活頁簿的其他位置。 | |
OLEObjects | 取得表示工作表上一個 OLE 物件 (Microsoft.Office.Interop.Excel.OLEObject) 或所有 OLE 物件集合 (Microsoft.Office.Interop.Excel.OLEObjects) 的物件。 | |
OnShutdown | 基礎架構。 | |
OnStartup | 基礎架構。 | |
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 | 基礎架構。 | |
ToString | 傳回表示目前物件的字串。 (繼承自 Object)。 | |
Unprotect | 移除工作表的保護。如果工作表未受到保護,這個方法不會有任何作用。 | |
XmlDataQuery | 取得 Range 物件,表示對應對特定 XPath 的儲存格。如果指定的 XPath 未對應至工作表,或對應的範圍為空白時,會取得 nullnull 參考 (即 Visual Basic 中的 Nothing)。 | |
XmlMapQuery | 取得 Range 物件,表示對應對特定 XPath 的儲存格。如果指定的 XPath 未對應至工作表,則會取得 nullnull 參考 (即 Visual Basic 中的 Nothing)。 |
回頁首
事件
名稱 | 說明 | |
---|---|---|
ActivateEvent | 會在工作表啟動時發生。 | |
BeforeDoubleClick | 會在按兩下工作表發生 (在預設按兩下動作執行之前)。 | |
BeforeRightClick | 會在工作表上按一下滑鼠右鍵時發生 (在預設滑鼠右鍵動作執行之前)。 | |
BindingContextChanged | 基礎架構。 | |
Calculate | 會在重新計算工作表後發生。 | |
Change | 會在 WorksheetBase 儲存格的內容改變時發生。 | |
Deactivate | 會在工作表失去焦點時發生。 | |
Disposed | 基礎架構。 | |
FollowHyperlink | 會在按一下工作表的超連結時發生。 | |
PivotTableAfterValueChange | 在樞紐分析表內的儲存格或儲存格範圍經過編輯或重新計算之後發生 (包含公式的儲存格)。這個事件只能在 Excel 2010 專案中使用。 | |
PivotTableBeforeAllocateChanges | 在變更套用到樞紐分析表之前發生。這個事件只能在 Excel 2010 專案中使用。 | |
PivotTableBeforeCommitChanges | 在針對樞紐分析表的 OLAP 資料來源認可變更之前發生。這個事件只能在 Excel 2010 專案中使用。 | |
PivotTableBeforeDiscardChanges | 在捨棄樞紐分析表的變更之前發生。這個事件只能在 Excel 2010 專案中使用。 | |
PivotTableChangeSync | 在變更樞紐分析表之後發生。這個事件只能在 Excel 2010 專案中使用。 | |
PivotTableUpdate | 會在工作表上的樞紐分析表報表更新時發生。 | |
SelectionChange | 會在工作表上的選取範圍變更時發生。 | |
Shutdown | 發生在工作表主項目關閉的時候。 | |
Startup | 基礎架構。 |
回頁首
明確介面實作
名稱 | 說明 | |
---|---|---|
EntryPoint.BeginInit | 基礎架構。 | |
EntryPoint.EndInit | 基礎架構。 | |
EntryPoint.FinishInitialization | 基礎架構。 | |
EntryPoint.Initialize | 基礎架構。 | |
EntryPoint.InitializeDataBindings | 基礎架構。 | |
EntryPoint.OnShutdown | 基礎架構。 | |
EntryPoint.OnStartup | 基礎架構。 | |
IExtension.ExtensionBase | 基礎架構。 | |
IWorksheetExtension.GetAutomationObject | 基礎架構。 |
回頁首
備註
WorksheetBase 類別是在使用 Visual Studio 所建立的文件層級 Excel 專案中 Sheetn 類別的基底類別。使用 Sheetn 類別以程式設計方式存取您專案中的工作表。WorksheetBase 類別是「主項目」(Host Item),它代表文件層級專案中的工作表。如需詳細資訊,請參閱主項目和主控制項概觀與Worksheet 主項目。
WorksheetBase 類別提供與 Excel 主要 Interop 組件中 Microsoft.Office.Interop.Excel.Worksheet 類別相同的成員,但是還加入了下列功能:
Controls 屬性。使用這個屬性在執行階段將 Managed 控制項加入到 Excel 工作表,或移除控制項。
InnerObject 屬性。使用這個屬性取得工作表主項目的基礎 Microsoft.Office.Interop.Excel.Worksheet 物件。
GetAutomationObject 方法呼叫的。覆寫這個方法,將專案中的類別公開給工作表中的 VBA 程式碼。
只有在 Excel 物件模型之應用程式層級提供的文件層級事件,例如 ActivateEvent 和 Change。也就是說,在 Excel 物件模型中,這些事件是定義於 Microsoft.Office.Interop.Excel.Application 類別,而不是定義於 Microsoft.Office.Interop.Excel.Worksheet 類別。
建立工作表主項目
您無法在 Office 專案中以程式設計方式建立 WorksheetBase 物件。
在文件層級專案中,當使用者開啟活頁簿時,Sheetn 類別 (衍生自 WorksheetBase) 就會由 Visual Studio Tools for Office Runtime 自動維護。如需詳細資訊,請參閱文件層級自訂程式設計。
在應用程式層級專案中,您可以使用 GetVstoObject 方法,以程式設計方式建立工作表主項目。您所建立的工作表主項目是 Microsoft.Office.Tools.Excel.Worksheet 物件,而不是 WorksheetBase 物件。如需詳細資訊,請參閱在應用程式層級增益集的執行階段中擴充 Word 文件和 Excel 活頁簿。
使用方式
這個型別只能用在以 .NET Framework 4 和 .NET Framework 4.5 為目標的 Office 專案。定義這個型別的組件並非 Visual Studio Tools for Office Runtime 的一部分。您必須將這個組件與您的方案一起部署。如需詳細資訊,請參閱 Visual Studio Tools for Office Runtime 的組件。
執行緒安全
這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。不保證任何執行個體成員是安全執行緒。
請參閱
參考
Microsoft.Office.Tools.Excel 命名空間
Worksheet Host Item