ListObject 介面

  • 發行項

ListObject 控制項會以一系列的列和欄顯示資料。

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

語法

'宣告
<GuidAttribute("48eb309a-698d-4d40-95af-d9d083e63d30")> _
Public Interface ListObject _
    Inherits IBindableComponent, IComponent, IDisposable, ISupportInitialize

[GuidAttribute("48eb309a-698d-4d40-95af-d9d083e63d30")]
public interface ListObject : IBindableComponent, 
    IComponent, IDisposable, ISupportInitialize

ListObject 型別會公開下列成員。

屬性

  名稱 說明
公用屬性 _Default 基礎架構。
公用屬性 Active 取得值，表示工作表上的 ListObject 控制項是否為現用；也就是說，現用儲存格是否在 ListObject 控制項的範圍中。
公用屬性 AlternativeText 取得或設定指定之表格的描述性 (替代) 文字字串。這個屬性只能在 Excel 2010 專案中使用。
公用屬性 Application 取得 Application，表示 Microsoft Office Excel 應用程式或 ListObject 的建立者。
公用屬性 AutoFilter 取得篩選過的表格。
公用屬性 AutoSelectRows 取得或設定值，表示當 SelectedIndex 變更時是否選取整個列。
公用屬性 AutoSetDataBoundColumnHeaders 取得或設定值，決定是否自動設定欄標題以符合資料來源。
公用屬性 BindingContext 取得或設定 IBindableComponent 的 Currency 管理員集合。 (繼承自 IBindableComponent)。
公用屬性 Comment 取得或設定與 ListObject 關聯的註解。
公用屬性 Container 基礎架構。
公用屬性 Creator 取得應用程式，ListObject 在此應用程式中建立。
公用屬性 DataBindings 取得這個 IBindableComponent 的資料繫結物件集合。 (繼承自 IBindableComponent)。
公用屬性 DataBodyRange 取得表示範圍的 Range，包含清單中標題列和插入列之間的資料區域。
公用屬性 DataBoundFormat 取得或設定有資料繫結之 ListObject 控制項的格式化樣式。
公用屬性 DataBoundFormatSettings 取得或設定指定之 XlRangeAutoFormat 的哪一個 FormatSettings 會套用至 ListObject 控制項。
公用屬性 DataMember 取得或設定要繫結至 ListObject 控制項的多成員資料來源中特定的資料成員。
公用屬性 DataSource 取得或設定包含值清單的來源，值會用來填入控制項中的項目。
公用屬性 DefaultDataSourceUpdateMode 取得或設定預設 DataSourceUpdateMode。
公用屬性 DisplayName 取得或設定顯示的名稱。
公用屬性 DisplayRightToLeft 取得值，指出 ListObject 是否為由右至左顯示而不是由左至右。
公用屬性 HeaderRowRange 取得 Range，表示標題列的範圍。
公用屬性 InnerObject 取得 Microsoft.Office.Interop.Excel.ListObject，表示 Microsoft.Office.Tools.Excel.ListObject 的基礎原生物件。
公用屬性 InsertRowRange 取得 Range，表示 ListObject 控制項的插入列 (如果有的話)。
公用屬性 IsBinding 取得值，指出資料繫結 (Data Binding) 是否為現用。
公用屬性 IsSelected 取得值，指出 ListObject 是否已選取。
公用屬性 ListColumns 取得 ListColumns 集合，表示 ListObject 控制項中所有的欄。
公用屬性 ListRows 取得 ListRows 物件，表示 ListObject 控制項中所有的資料列。
公用屬性 MappedColumns 基礎架構。
公用屬性 Name 取得或設定 ListObject 控制項的名稱。
公用屬性 Parent 取得 ListObject 控制項的父物件。
公用屬性 QueryTable 取得 QueryTable，提供 ListObject 控制項的連結給清單伺服器。
公用屬性 Range 取得 Range，表示 ListObject 所套用的範圍。
公用屬性 SaveSortOrder 取得或設定值，指出 ListObject 控制項的列順序是否儲存在工作表上。
公用屬性 SelectedIndex 取得或設定目前選取之列的索引。
公用屬性 SharePointURL 取得指定之 ListObject 控制項的 SharePoint 清單 URL。
公用屬性 ShowAutoFilter 取得或設定值，指出是否顯示 [自動篩選]。
公用屬性 ShowHeaders 取得或設定值，指出是否應顯示標題資訊。
公用屬性 ShowTableStyleColumnStripes 取得或設定值，指出是否使用「欄條紋」表格樣式。
公用屬性 ShowTableStyleFirstColumn 取得或設定值，指出是否格式化第一欄。
公用屬性 ShowTableStyleLastColumn 取得或設定值，指出是否格式化最後一欄。
公用屬性 ShowTableStyleRowStripes 取得或設定值，指出是否使用「列條紋」表格樣式。
公用屬性 ShowTotals 取得或設定值，指出總計列是否為可見的。
公用屬性 Site 取得或設定與 IComponent 相關聯的 ISite。 (繼承自 IComponent)。
公用屬性 Sort 取得 ListObject 集合的排序資料行和排序次序。
公用屬性 SourceType 取得清單的目前來源。
公用屬性 Summary 取得或設定與指定表格之替代文字字串相關聯的描述。這個屬性只能在 Excel 2010 專案中使用。
公用屬性 TableStyle 取得或設定表格樣式。
公用屬性 Tag 取得或設定包含有關 Tag 控制項資料的物件。
公用屬性 TotalsRowRange 取得 Range，表示 ListObject 控制項的總計列。
公用屬性 XmlMap 取得 XmlMap，表示供清單使用的結構描述對應。

回頁首

方法

  名稱 說明
公用方法 BeginInit 表示物件正在啟動初始設定。 (繼承自 ISupportInitialize)。
公用方法 Delete 刪除動態建立的 ListObject 控制項，從工作表清除儲存格的資料，並從 ControlCollection 移除這個控制項。
公用方法 Disconnect 從 ListObject 控制項移除資料繫結。
公用方法 Dispose 執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承自 IDisposable)。
公用方法 EndInit 表示物件已完成初始設定。 (繼承自 ISupportInitialize)。
公用方法 ExportToVisio 將 ListObject 匯出至 Visio。
公用方法 Publish 將 ListObject 控制項發行至執行 Microsoft Windows SharePoint Services 的伺服器。
公用方法 Refresh 使用來自執行 Microsoft Windows SharePoint Services 之伺服器的目前資料和結構描述，更新 ListObject 控制項。
公用方法 RefreshDataRow 會更新與指定之資料列關聯的 ListObject 資料列。
公用方法 RefreshDataRows 會以來自資料來源的資料更新 ListObject 中所有的資料列。
公用方法 ResetPersistedBindingInformation 清除使用者對 ListObject 控制項所做之變更的資訊。
公用方法 Resize 讓 ListObject 控制項可以調整大小至新的範圍。
公用方法 SetDataBinding(Object) 將 ListObject 控制項繫結至資料來源。
公用方法 SetDataBinding(Object, String) 將 ListObject 控制項繫結至資料來源中指定的資料成員。
公用方法 SetDataBinding(Object, String, array<String[]) 將 ListObject 控制項繫結至資料來源中指定的資料成員，並只顯示此資料成員中指定的欄。
公用方法 Unlink 從 ListObject 控制項移除 Microsoft Windows SharePoint Services 網站的連結。
公用方法 Unlist 從 Microsoft.Office.Interop.Excel.ListObject 控制項移除清單功能。
公用方法 UpdateChanges 使用工作表中 ListObject 控制項的變更，更新 Microsoft Windows SharePoint Services 網站上的清單。

回頁首

事件

  名稱 說明
公用事件 BeforeAddDataBoundRow 在嘗試將新的列加入至繫結至資料的 ListObject 控制項之前發生。
公用事件 BeforeDoubleClick 會在按兩下 ListObject 控制項時發生 (在預設按兩下動作執行之前)。
公用事件 BeforeRightClick 會在 ListObject 控制項上按一下滑鼠右鍵時發生 (在預設按滑鼠右鍵動作執行之前)。
公用事件 BindingContextChanged 基礎架構。
公用事件 Change 在 ListObject 控制項變更時發生。
公用事件 DataBindingFailure 當某個條件導致 ListObject 控制項的資料繫結失敗時便會發生。
公用事件 DataMemberChanged 在 DataMember 屬性變更時發生。
公用事件 DataSourceChanged 於 DataSource 屬性變更時發生。
公用事件 Deselected 當選取範圍從 ListObject 控制項移至 ListObject 控制項之外時發生。
公用事件 Disposed 表示處理元件的 Disposed 事件的方法。 (繼承自 IComponent)。
公用事件 ErrorAddDataBoundRow 當使用者嘗試將一列加入至有資料繫結的 ListObject 控制項，但是無法加入此列時發生。
公用事件 OriginalDataRestored 當使用者執行不允許的動作時發生，ListObject 控制項接著會還原至原始狀態。
公用事件 Selected 在選取 ListObject 控制項時發生。
公用事件 SelectedIndexChanged 在 SelectedIndex 屬性變更時發生。
公用事件 SelectionChange 當選取範圍在 ListObject 控制項內變更時發生。

回頁首

備註

如需詳細資訊，請參閱ListObject 控制項。

注意事項注意事項

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

使用方式

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

請參閱

參考

Microsoft.Office.Tools.Excel 命名空間