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 命名空間